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: 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.lineentries.--dry-runshows 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.
--jsonoutput follows JSON Schemas, and errors come as one envelope with a stablekind.llm --skillprints 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.
Tutorials
Learn by doing. Try it offline without Odoo, then book your first entry and take the TUI tour.
How-to guides
Recipes: book time, clock in and out, find projects and tasks, script with JSON, use it from an agent or an MCP client.
Reference
Look things up: every command and flag, JSON output, errors and exit codes, configuration and TUI keys.
Explanation
Why it works the way it does: config layering, secrets, the two transports and the attendance model.
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:
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.