CLI: Getting Started

The Keito CLI lets you track time and log expenses from your terminal. It’s designed for developers running agents locally or in CI pipelines.

Install

# macOS (Homebrew)
brew install keito-io/tap/keito

# npm (cross-platform)
npm install -g @keito/cli

# From source
cargo install keito-cli

Authenticate

keito auth login

This opens a browser window. Log in, authorise the CLI, and you’re set. Your credentials are stored securely in your system keychain.

Alternatively, set environment variables:

export KEITO_API_KEY="keito_sk_abc123..."
export KEITO_ACCOUNT_ID="acc_xyz789"

Verify

keito whoami

Output:

✓ Authenticated as review-bot-01
  Workspace: Acme Consulting
  Account:   acc_xyz789

Quick Start

# Start a timer on a project
keito time start --project acme --task development

# Stop the timer with notes
keito time stop --notes "Fixed authentication bug"

# Log a completed block of time
keito time log --project acme --task development \
  --hours 1.5 --notes "Implemented OAuth flow"

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

Next Steps