CLI Reference¶

The kai command is Kaisho's command-line interface. Every feature available in the web UI is also accessible from the terminal.

Global Options¶

kai [--profile, -p PROFILE] <command>

Option	Description
`--profile`, `-p`	Profile to use (overrides active profile)

The profile can also be set via the PROFILE environment variable.

Commands¶

Command	Description
`clock`	Time tracking: start, stop, book, list entries
`task`	Task management: add, move, tag, archive
`customer`	Customer CRUD
`contract`	Contract management with budgets
`inbox`	Capture and triage inbox items
`notes`	Notes with customer and task links
`kb`	Knowledge base search and browsing
`cron`	Scheduled AI job management
`ask`	Query the AI advisor
`gh`	GitHub issues and pull requests
`backup`	Backup and restore data
`profiles`	Profile management
`config`	Task states and system configuration
`briefing`	Morning overview
`serve`	Start the API server
`convert`	Migrate between storage backends
`youtube`	YouTube transcript tools

JSON Output¶

Most commands support --json for machine-readable output:

kai task list --json
kai clock summary --json | jq '.customers[0].hours'

Editor Integration¶

Commands with an edit subcommand open the data file in your editor. Set $VISUAL or $EDITOR:

export EDITOR=vim
kai task edit        # opens todos.org in vim
kai clock edit       # opens clocks.org

Command Bar¶

All CLI commands are also available inside the web UI via the command bar (Cmd+J). Type clock start Acme or task list without leaving the browser.