CLI reference

Everything is driven by the orchestrator CLI — 41 commands across 7 areas. This page covers the most-used commands; run orchestrator <area> --help for the full list.

Understand

orchestrator understand .            # extract & query the graph
orchestrator understand . --report   # deterministic report (diffable in CI)

Query

Command	What it does
`orchestrator blast_radius --symbol <name>`	what breaks if I change this
`orchestrator regression <symbol>`	reachable, untested symbols
`orchestrator explain <symbol>`	what it is and who uses it
`orchestrator localize --trace <file>`	map a stack trace to code
`orchestrator root_cause <symbol>`	why it’s happening + fix shape

Deliver (gated)

orchestrator sdlc feature --safe     # grounded codegen + tests, no external write
orchestrator sdlc fix --safe

Runs stop at both governance gates. With --safe, nothing is pushed or merged until you approve.

Docs & audit

Command	What it does
`orchestrator doc_drift`	find docs lying about the code
`orchestrator audit`	replay the append-only log