CLI Reference
Reference for the Kitaru command-line interface.
Reference pages for every kitaru command, generated from the CLI's own schema output.
Global options
Every command accepts these options in addition to its own.
| Name | Type | Required | Description |
|---|---|---|---|
--output/-o | auto|text|json|jsonl | No | Serialization mode. |
--machine/--no-machine | boolean | No | Terminal rendering mode. |
--server | URL | No | Server URL override. |
--non-interactive | boolean | No | Disable interaction. |
--no-browser | boolean | No | Disable browser launch. |
--request-timeout | positive float | No | HTTP timeout. |
--debug | boolean | No | Redacted debug diagnostics. |
--traceback | boolean | No | Redacted traceback. |
The --output type above is the union across all commands; each command page lists the modes that command supports.
Commands
| Command | Description |
|---|---|
agent | Register and inspect agents. |
analyzer | Register and inspect analyzers. |
annotation | Create and manage session annotations. |
cohort | Manage cohort namespaces and immutable membership versions. |
config | Manage allowlisted CLI preferences. |
connection | Create and manage provider connections. |
doctor | Run independent local, server, authentication, and tooling checks. |
evaluation | Inspect stored evaluations. |
evaluator | Develop, register, and inspect evaluators. |
experiment | Configure experiments and manage asynchronous runs. |
import | Inspect imports and rerun analyzers over them. |
importer | Develop, register, and inspect importers. |
info | Show local runtime details and resolved server information. |
insight | Create and inspect agent insights. |
investigation | Create investigations and review their linked sessions. |
job | Inspect, watch, and cancel jobs. |
local | Inspect the CLI-owned local Kitaru deployment. |
login | Authenticate with managed cloud (14-day trial, no credit card required) or a Kitaru server. |
logout | Disconnect from a server and stop an owned local deployment. |
replay | Create and inspect standalone replays. |
schema | Describe the CLI command tree from offline registration metadata. |
session | Import and inspect sessions and their nodes. |
setup | Install the agent skills and register the MCP server with every detected coding agent. Re-run after installing a new one. The global --server picks the server the MCP server targets. |
status | Show connection, authentication, compatibility, and live-worker status. |
version | Show the installed Kitaru version. |
worker | Run and inspect generic local workers. |