CLI: Logging Expenses

Log project expenses directly from your terminal.

Basic Expense Logging

keito expense log --project acme \
  --category "LLM Usage" \
  --quantity 45 \
  --notes "claude-opus-4-6: 30k input + 15k output tokens"

Options

Flag	Description	Required
--project	Project slug or ID	Yes
--category	Expense category name or ID	No (defaults to “LLM Usage” in agent mode)
--quantity	Number of units	Yes
--total	Total cost (alternative to quantity × unit price)	No
--notes	Description	No
--date	Date (YYYY-MM-DD, default today)	No

LLM Usage Shorthand

In agent mode, the CLI defaults to the “LLM Usage” category:

# These are equivalent in agent mode
keito expense log --project acme --quantity 45
keito expense log --project acme --category "LLM Usage" --quantity 45

Listing Expenses

# Today's expenses
keito expense list

# Filter by project
keito expense list --project acme

# Filter by source
keito expense list --source agent