CLI reference

Every command discovers the workspace from cwd (project mode, 0.9+). Run them inside the project directory, or target one from anywhere with --project / -p <id>. For the full, always-current surface run ortim --help.

Health & setup

ortim doctor                       # environment + asset health check
ortim config init                  # one-time provider / model / key wizard
ortim config show                  # what's active, and where each value came from
ortim config set-role architect --provider anthropic   # per-role override

Project flow

mkdir ~/dev/cool && cd ~/dev/cool
ortim init "<brief>"               # create the .ortim/ workspace (auto greenfield/brownfield)
ortim run                          # Babel + Analyst → MVP_SCOPE_LOCKING
ortim scope --lock                 # accept default phase split + advance to G1
ortim show --artifact prd          # review the PRD
ortim advance prd_approved         # gate G1
ortim run                          # Architect → RFC_AWAITING_APPROVAL
ortim show --artifact rfc          # review the RFC
ortim advance rfc_approved         # gate G2
ortim run                          # Orchestrator → tasks_ready
ortim run-all --phase 1            # Worker × N execute the MVP tasks

Observability

ortim status                       # current state + history
ortim tasks                        # task DAG and per-task status
ortim retro                        # token + USD cost rollup
ortim drift-check                  # RFC ↔ DAG ↔ status integrity
ortim audit-verify                 # confirm the hash-chained audit log is untampered
ortim show --artifact rfc          # print any produced artifact

Iteration

ortim refine "<feedback>"          # dialog-mode refine of the current artifact
ortim extend "<new feature>"       # DONE project → delta cycle for a new feature

Workspace management

These work from anywhere — the registry tracks every known workspace.

ortim ls                           # all known workspaces; '*' marks the active one
ortim use <id|name>                # set the active pointer
ortim status -p <id>               # target a specific workspace
ortim workspace archive <id>
ortim workspace cleanup --older-than 30 --archived-only --yes

Demo

ortim demo                         # end-to-end walkthrough, no input required
ortim demo --provider ollama       # ...with zero API keys, fully local