Skip to content

Book time

How to add, change and delete timesheet entries on the command line. In the TUI the same works with A, E and D in the detail view; see the TUI tour.

Add an entry

odoo-work-cli entries add --project-id 42 --task-id 10 --hours 2:30 \
  --description "Code review"
  • --project-id, --hours and --description are required.
  • --task-id is optional. The task must belong to the project.
  • --date YYYY-MM-DD books on another day; the default is today.
  • Hours are H:MM (2:30) or decimal (2.5).

Don't know the IDs? Find projects and tasks. Not sure? Add --dry-run first: Preview a write.

See what is booked

odoo-work-cli entries                           # current week
odoo-work-cli entries --week 2026-W15
odoo-work-cli entries --date 2026-04-08
odoo-work-cli entries --project lighthouse --status draft
odoo-work-cli timesheets --week 2026-W15        # weekly summary with total
$ odoo-work-cli timesheets --week 2026-W15
Week: 2026-04-06 to 2026-04-12

ID       Date         ProjID   Project                   TaskID   Task                      Description                    Hours
-------- ------------ -------- ------------------------- -------- ------------------------- ------------------------------ -----
4019     2026-04-09   3        Internal                  31       Meetings                  Customer call                  0.75
4018     2026-04-09   1        Lighthouse Portal         13       Code review               Review fuzzy matching          1.50
4017     2026-04-09   2        Orchard Mobile App        21       Release 2.4               Store screenshots              2.00
4016     2026-04-08   3        Internal                  32       Training                  Accessibility workshop         1.50
4015     2026-04-08   2        Orchard Mobile App        22       Support                   Crash report on login          2.50
4014     2026-04-08   1        Lighthouse Portal         12       Frontend                  Result list layout             4.00
4013     2026-04-07   4        Riverbank Data Migration  41       Data mapping              Import dry run                 3.50
4012     2026-04-07   3        Internal                  31       Meetings                  Weekly sync                    1.00
4011     2026-04-07   1        Lighthouse Portal         11       Backend API               Search: fuzzy matching         3.50

Total: 20.25 hours

--project and --task match a part of the name, ignoring case. --status is Odoo's validation status (draft, validated).

Change an entry

Only the flags you pass are sent:

odoo-work-cli entries update 4019 --hours 1:15
odoo-work-cli entries update 4019 --description "Customer call (pricing)" --date 2026-04-08

update also takes --project-id and --task-id. Preview with --dry-run: it shows the entry with your changes merged in.

Delete an entry

odoo-work-cli entries delete 4019

A wrong ID fails with not_found before anything is deleted. With --json the output is the entry as it was, so you can book it again if needed.

Book many entries from a script

Use --json and stop on the first error; see Script with JSON output.