otta-cli
بواسطة mekedron
Browser & Automationموجز
Use `otta-cli` to automate `otta.fi` workflows from terminal.
الوصف
ما الذي تفعله هذه المهارة
otta-cli is a command-line interface for the otta.fi time-tracking platform. It covers authentication, worktime CRUD, absence browsing, holiday fetching, saldo checks, and calendar report generation. All commands support machine-readable JSON output for scripting and CI use.
Exposes the full otta.fi feature set as scriptable CLI commands with JSON output, enabling automation that the web UI alone cannot provide.
متى تستخدمها
- Log today's work hours from a terminal script
- Pull a monthly absence report into a pipeline
- Check cumulative saldo before end-of-month submission
- Automate worktime entries from a CI job
- Generate a detailed day-by-day calendar report for a pay period
مثال على سير العمل
User asks: Add a worktime entry for Feb 20, 2026, 9am to 5pm with a 30-minute pause
- 1
Run
otta status --format jsonto refresh cached user and worktimegroup metadata - 2
Resolve project and worktype IDs from prior context or prompt user to supply them
- 3
Run
otta worktimes add --date 2026-02-20 --start 09:00 --end 17:00 --pause 30 --project <project-id> --worktype <worktype-id> --format json - 4
Parse the JSON response to confirm the new entry ID and recorded times
Worktime entry created with confirmed ID, date, and duration fields from the JSON response
المتطلبات
- otta.fi account credentials (username and password)
- OTTA_CLI_USERNAME and OTTA_CLI_PASSWORD environment variables for non-interactive use
- otta binary installed from https://github.com/mekedron/otta-cli
التثبيت
clawhub install mekedron/otta-cliشغّل أمر واجهة سطر الأوامر، أو الصق النص في Claude Code أو Cursor أو Codex أو أي وكيل برمجة تستخدمه.