CLI Reference

kew provides 30 commands for dispatch, monitoring, and maintenance.

Command	Description
kew run	Pick next ready issue and dispatch to Claude Code.
kew dispatch	Dispatch an issue. With --loop, supervise the runner as a first-class loop.
kew setup	Create labels, security hooks, and directories.
kew skills	Install and maintain kew's shipped agent skills and security-guard hook.
kew status	Show dispatch queue status.
kew review	Gather PR review comments and dispatch agent to address them.
kew resolve	Resolve merge conflicts on an agent PR branch.
kew ci-fix	Dispatch CI failure auto-fix for a GitHub Actions run.
kew backfill-first-edit	Derive steps/tokens-to-first-edit from existing transcripts.
kew tui	Launch the terminal dashboard.
kew serve	Serve the kew web UI + API + approval inbox on localhost.
kew cleanup	Find and fix orphaned label states left after a crash.
kew stop	Kill all in-flight agent runs and halt dispatch until kew resume.
kew resume	Clear the fleet-stop latch and re-enable dispatch.
kew attach	Attach to a running agent's live event stream.
kew export	Export run history to JSON or CSV.
kew report	Generate an outcome-linked spend report in markdown.
kew approve	Release a needs-approval hold (records approval_granted).
kew deny	Deny a needs-approval hold (records approval_declined; parks the issue).
kew health	Attest the control plane is functioning: meter, budgets, audit, runner.
kew canary	Attest kew still reads fresh vendor CLI output correctly (#265).
kew sync	Backfill PR outcomes (merged/closed, reviews, diff stats) for past runs.
kew backup	Snapshot the dispatch.db record (+ config) into a portable archive.
kew restore	Restore a backup archive into the configured log directory.
kew audit	Inspect the audit trail (audit_events in dispatch.db).
kew loop	Manage first-class loops.
kew ingest	Ingest external runner usage (#256).
kew pricing	Sync the committed OpenRouter pricing snapshot; check it for drift.
kew epic	Build, validate, visualize, and drive an epic dependency graph (reads: GitHub or Linear).
kew sandbox smoke	Launch one container end-to-end and name the first failing layer (sandboxed-dispatch preflight).