Skip to content

odoo-work-cli

Version

Documentation for odoo-work-cli 0.9.1.

odoo-work-cli books Odoo 17 timesheets and attendance from the terminal. It has a CLI for scripts and coding agents, with stable JSON output and error kinds, and a TUI for the weekly grid.

The TUI: weekly grid with attendance per day

The TUI: one row per project and task, today's column selected, attendance per day below the totals.

What it does

  • Timesheets. List, add, update and delete account.analytic.line entries. --dry-run shows what would be written.
  • Attendance. Clock in and out, also for regular employees and accounts with 2FA (TOTP). Backdate, fix or add records for a forgotten day.
  • Projects and tasks. Search Odoo's projects and tasks to find the IDs to book on.
  • A contract for machines. --json output follows JSON Schemas, and errors come as one envelope with a stable kind. llm --skill prints a guide for coding agents.
  • Offline. A built-in fake backend runs every command without Odoo, network or 1Password. The examples and screenshots in these docs come from it.

Where to start

The docs follow Diátaxis: four sections, one for each kind of question.

About these docs

The site is published at https://seletz.github.io/odoo-work-cli/. The sources are in the repository under docs/. To view them locally:

mise run docs:serve

The build is strict: a dead link or a missing sample fails it (mise run docs:build).

Screenshots, CLI samples and the command reference are generated from the code and the fake backend at a fixed date (Thursday, 9 April 2026). mise run docs:screenshots and mise run docs:reference regenerate them; the CI fails when the committed files are stale. All names in the examples are made up.