kai clock¶
Time tracking: start and stop timers, book retroactive entries, list and edit time records.
Commands¶
clock start¶
Start a running timer.
| Argument | Description |
|---|---|
CUSTOMER | Customer name |
DESCRIPTION | Optional description (multiple words) |
clock stop¶
Stop the active timer.
| Option | Description |
|---|---|
--desc | Set description before stopping |
--notes | Set notes before stopping |
--customer | Reassign to different customer |
--json | JSON output |
clock status¶
Show the active timer.
clock book¶
Book time retroactively.
| Argument | Description |
|---|---|
DURATION | Duration string (e.g., 2h, 30min, 1h30min) |
CUSTOMER | Customer name |
DESCRIPTION | Optional description |
kai clock book 2h "Acme Corp" "Morning standup + planning"
kai clock book 30min "Beta Inc" "Quick bug fix"
clock desc¶
Set description on the running timer.
clock note¶
Add notes to the running timer.
clock list¶
List clock entries with filtering.
| Option | Description |
|---|---|
--week | Show this week |
--month | Show this month |
--customer | Filter by customer |
--from | Start date (YYYY-MM-DD) |
--to | End date (YYYY-MM-DD) |
--json | JSON output |
clock summary¶
Show total hours per customer.
| Option | Description |
|---|---|
--week | Summarize this week (default: month) |
--json | JSON output |
clock update¶
Update a clock entry by its start timestamp.
| Option | Description |
|---|---|
--customer | New customer |
--description | New description |
--hours | Duration in hours (float) |
--date | New date (YYYY-MM-DD) |
--task-id | Link to task (empty to remove) |
--invoiced / --no-invoiced | Invoiced status |
--notes | New notes |
--contract | Assign to contract |
clock batch-invoice¶
Mark all uninvoiced entries for a customer as invoiced.
clock edit¶
Open the clocks file in $EDITOR.