CLI Reference

Kavi provides a comprehensive set of CLI commands for managing multi-agent sessions, routing tasks, inspecting state, and integrating results.

Session Management

Commands for initializing, starting, and managing Kavi sessions.

Command	Description
kavi init	Create repo-local config, prompt files, ignore rules, and bootstrap git
kavi doctor	Verify system dependencies and local readiness
kavi open	Create a managed session with worktrees and open the TUI
kavi start	Start a managed session without the TUI
kavi resume	Reopen the TUI for the current repo session
kavi stop	Stop the background daemon for the current session

Commands for creating and inspecting tasks.

Command	Description
kavi task	Enqueue a task for codex, claude, or auto routing
kavi tasks	Inspect the session task list with summaries
kavi task-output	Inspect normalized envelope and raw output for a completed task
kavi plan	Inspect the current execution graph from the planning pass

Commands for viewing session state and progress.

Command	Description
kavi status	Inspect session health, task counts, and routing ownership rules
kavi summary	Cohesive session-level view of progress, changes, activity, and readiness
kavi result	Current or latest landed outcome with per-agent output
kavi activity	Session as a linear activity stream

Commands for inspecting and previewing task routing.

Command	Description
kavi route	Preview how Kavi would route a prompt
kavi routes	Inspect recent routing decisions with strategy, confidence, and metadata
kavi paths	Inspect resolved repo-local, user-local, worktree, and runtime paths

Commands for inspecting review threads, claims, and decisions.

Command	Description
kavi claims	Inspect active and historical path claims
kavi reviews	Inspect review threads and follow-up tasks
kavi decisions	Inspect routing, approval, task, and integration decisions
kavi events	Inspect recent daemon and task events

Commands for managing approval requests.

Command	Description
kavi approvals	Inspect the approval inbox
kavi approve / kavi deny	Resolve a pending approval request

Commands for managing recommendations from agents.

Command	Description
kavi recommend	Inspect recommendations
kavi recommend-apply	Turn a recommendation into a queued managed task
kavi recommend-dismiss	Dismiss or restore recommendations

Commands for landing and merging work.

Command	Description
kavi land	Snapshot worktrees, merge in integration worktree, run validation, fast-forward target branch

Commands for updating and checking Kavi itself.

Command	Description
kavi update	Check for and install a newer published Kavi package
kavi version	Print the installed package version