Skip to content
TakoAPI
Back to skills

otta-cli

by mekedron

Browser & Automation
335Downloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User asks: Add a worktime entry for Feb 20, 2026, 9am to 5pm with a 30-minute pause

AGENT
  1. 1

    Run otta status --format json to refresh cached user and worktimegroup metadata

  2. 2

    Resolve project and worktype IDs from prior context or prompt user to supply them

  3. 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. 4

    Parse the JSON response to confirm the new entry ID and recorded times

OUTPUT

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-cli

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links