CLI: Tracking Time

The CLI supports two time tracking approaches: running timers and manual time logging.

Starting a Timer

keito time start --project acme --task development

This creates a running time entry. The timer ticks until you stop it.

Options

Flag	Description	Required
--project	Project slug or ID	Yes
--task	Task slug or ID	No
--notes	Initial notes	No
--billable	Mark as billable (default from project)	No

Stopping a Timer

keito time stop --notes "Completed code review for PR #42"

This stops the running timer, calculates the duration, and saves the entry.

Options

Flag	Description
--notes	Add or update notes
--round	Round to nearest increment (e.g., 15m, 6m)
--discard	Delete the entry instead of saving

Manual Time Logging

For work that’s already completed:

keito time log --project acme --task development \
  --hours 1.5 \
  --date 2026-03-06 \
  --notes "Implemented OAuth flow"

Options

Flag	Description	Required
--project	Project slug or ID	Yes
--task	Task slug or ID	No
--hours	Duration in decimal hours	Yes
--date	Date (YYYY-MM-DD, default today)	No
--notes	Description of work	No
--billable	Mark as billable	No

Listing Time Entries

# Today's entries
keito time list

# Entries for a specific date
keito time list --date 2026-03-06

# Entries for a project
keito time list --project acme

Check Running Timer

keito time status

Output:

⏱ Timer running: 1h 23m
  Project: Acme Consulting
  Task:    Development
  Started: 2026-03-06 09:15