CLI: Command Reference

Authentication

Command	Description
keito auth login	Authenticate via browser
keito auth logout	Clear stored credentials
keito whoami	Show current user and workspace

Time Tracking

Command	Description
keito time start	Start a running timer
keito time stop	Stop the running timer
keito time log	Log a completed block of time
keito time list	List time entries
keito time status	Show running timer status
keito time delete <id>	Delete a time entry

keito time start

keito time start [flags]

Flags:
  --project      Project slug or ID (required)
  --task         Task slug or ID
  --notes        Initial notes
  --billable     Mark as billable
  --source       Source value (web, cli, api, agent)
  --agent-id     Agent identifier (sets source to agent)
  --session-id   Session UUID for correlation

keito time stop

keito time stop [flags]

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

keito time log

keito time log [flags]

Flags:
  --project      Project slug or ID (required)
  --task         Task slug or ID
  --hours        Duration in decimal hours (required)
  --date         Date YYYY-MM-DD (default: today)
  --notes        Description of work
  --billable     Mark as billable
  --source       Source value
  --agent-id     Agent identifier
  --session-id   Session UUID

Expenses

Command	Description
keito expense log	Log an expense
keito expense list	List expenses

keito expense log

keito expense log [flags]

Flags:
  --project      Project slug or ID (required)
  --category     Expense category name or ID
  --quantity     Number of units (required)
  --total        Total cost (alternative to quantity)
  --notes        Description
  --date         Date YYYY-MM-DD (default: today)
  --source       Source value

Configuration

Command	Description
keito config init	Create config file
keito config set <key> <value>	Set a config value
keito config list	Show current configuration

Global Flags

Flag	Description
--help	Show help for any command
--version	Show CLI version
--json	Output in JSON format
--quiet	Suppress non-essential output