Kitaru

CLI Reference

Durable execution for AI agents. Create deployments with `kitaru deploy`; inspect existing deployments with `kitaru flow`.

Usage

kitaru COMMAND [OPTIONS]

Global Flags

FlagDescription
--help, -hDisplay help and exit
--version, -VDisplay the installed version and exit

Output formats

Most agent-facing commands support --output json (or -o json) in addition to the default text output.

  • Text output is designed for people reading the terminal directly.
  • JSON output is designed for agents and scripts that need a stable structure.
  • Single-item commands emit {command, item}.
  • List commands emit {command, items, count}.
  • kitaru executions logs --follow --output json is the special case: it emits one JSON event per line while following the stream.

Parameters

NameTypeRequiredDefaultDescription
--versionboolNoFalseShow the Kitaru version and exit.

Commands

CommandDescription
analyticsManage anonymous usage analytics preferences.
authManage active Kitaru server authentication helpers.
buildBuild an immutable deployment version from a flow target.
cleanReset Kitaru state.
deployDeploy a new flow version and attach one routing tag.
executionsInspect and manage flow executions.
flowInspect existing deployments and manage deployment routing. Create new deployments with kitaru deploy.
infoShow detailed environment information for the current setup.
initInitialize a Kitaru project in the current directory.
invokeInvoke a deployed flow snapshot.
log-storeManage global runtime log-store settings.
loginConnect to a remote server, or start and connect to a local server.
logoutLog out from the current Kitaru server and clear stored auth state.
memoryInspect and manage persisted memory entries.
modelManage local model aliases for kitaru.llm().
secretsManage centralized runtime secrets.
stackInspect, create, delete, and switch stacks.
statusShow the current connection state and active stack context.

On this page