CLI commands

All orion CLI commands — lifecycle, memory, brain, graph, sun, and audit.

cd backend && pip install -e .

Lifecycle

Command	Description
orion start	Boot Docker services + open TUI
orion start --detach	Boot in background
orion start --build	Rebuild images first
orion stop	Shut down all services
orion tui	Open TUI (services must be running)
orion init	6-step onboarding wizard

Memory

orion memory write "We chose PostgreSQL for JSON support" -p Engineering
orion memory write "Deploy: make build && kubectl apply" -p Engineering --region procedural
orion memory write "Always use UTC" -p Engineering --gravity GALAXY --confidence 0.95

Flag	Default	Description
-p, --planet	Required	Target planet
-b, --biome	—	Target biome
--region	contextual	Cognitive region
--confidence	0.5	0.0–1.0
--gravity	BIOME	BIOME | PLANET | GALAXY
--tags	—	Comma-separated

orion memory search "database decisions"
orion memory search "auth patterns" -p Engineering -n 10
orion memory status
orion memory import ~/Documents/notes/

Aliases: orion search → orion memory search, orion write → orion memory write.

Brain

orion brain status claude-code-main     # identity + top expertise
orion brain health claude-code-main     # full health report
orion brain expertise claude-code-main  # domain breakdown
orion brain sessions claude-code-main   # session history
orion brain switches claude-code-main   # model switch history

Knowledge graph

orion graph query PostgreSQL            # 2-hop neighborhood
orion graph query PostgreSQL -d 3 --type USES
orion graph path FastAPI Redis          # shortest path
orion graph hubs -n 10                  # most connected entities
orion graph unlinked                    # unlinked mentions

Sun

orion sun show                          # all sections
orion sun read working-context          # specific section
orion sun edit working-context          # open in $EDITOR
orion sun update working-context '{"current_focus": "Auth refactor"}'

Audit

orion audit                             # last results
orion audit --run                       # trigger manually

Connection

orion connect claude                    # MCP setup instructions
orion connect cursor