CLI Reference

Complete reference for the rai command-line interface. Commands are organized in workflow order — from project setup through release.

Global Options¶

These options are available on all commands:

Flag	Short	Description
`--version`	`-V`	Show version and exit
`--format`	`-f`	Output format: `human`, `json`, or `table`
`--verbose`	`-v`	Increase verbosity (`-v`, `-vv`, `-vvv`)
`--quiet`	`-q`	Suppress non-error output
`--help`		Show help and exit

Command	Description
init	Initialize a RaiSE project
upgrade	Update an existing project to the latest version
connect	Connect to a RaiSE server via device authorization
whoami	Show current identity and organization
manifest	Manage `.raise/manifest.yaml`

Command	Description
session	Manage working sessions
mission	Manage missions — bounded work containers
story	Composite story bookends (open/close)
worktree	Manage git worktrees
fleet	Fleet dispatch — DAG-based parallel story execution
backlog	Manage backlog items via adapters

Command	Description
graph	Build, query, and manage the knowledge graph
cartridge	Cartridge management and validation
discover	Codebase discovery and analysis
pattern	Manage learned patterns
learn	Manage learning records
memory	Memory management (mostly deprecated aliases)

Command	Description
gate	Discover and run workflow gates
drift	Drift health checks for codebase modules
impact	Analyze changed files and recommend validation gates
governance	Governance artifact sync
schema	Schema integrity tools
eval	Evaluation harness for retrieval quality

Command	Description
adapter	Inspect and validate adapters
mcp	Manage MCP servers
docs	Publish and retrieve documentation
skill	Manage RaiSE skills and skill sets

Command	Description
db	SQLite personal database diagnostics and backup
daemon	Manage the rai-agent daemon lifecycle
hud	Launch the live terminal dashboard
signal	Emit lifecycle and telemetry signals
telemetry	Telemetry configuration

Command	Description
project	Manage projects on RaiSE server
repo	Manage repositories on RaiSE server

Command	Description
release	Release management
info	Display package information
profile	View developer profile
doctor	Diagnose setup and auto-fix issues

Command	Description
artifact	Structured story artifacts (MCP-only)
pipeline	Pipeline orchestration (MCP-only)
base	Deprecated — use `rai info`