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¶
--project-id,--hoursand--descriptionare required.--task-idis optional. The task must belong to the project.--date YYYY-MM-DDbooks 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¶
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.