otta-cli
by mekedron
Browser & AutomationBrief
Use `otta-cli` to automate `otta.fi` workflows from terminal.
Description
What This Skill Does
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.
When to Use It
- 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
Example Workflow
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
Requirements
- 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
Installation
clawhub install mekedron/otta-cliRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.