CLI reference
Hand-written mirror of the shipped flags and subcommands. The GitHub README is canonical.
Usage: orch [options] [command] <task...>Flags
- -V, --version
- Outputs the version number.
- -v, --verbose
- Streams agent thinking/output deltas to stderr as the pipeline runs.
- --dry-run
- Checks that the selected agent CLI is on PATH and exits without running the pipeline.
- --ask
- Asks a read-only question about the codebase; prints the reply and exits.
- --quick
- Skips triage, runs quick-fix directly in the current working tree; creates no markdown artifacts, worktrees, or commits (job record only).
- --detach
- Runs the pipeline in the background and returns immediately, printing started <slug> (pid <pid>); rejects --ask / --quick / --dry-run.
- --max-rounds <n>
- Max writer⇄critic and writer⇄runner iterations per implementer loop; defaults to 5.
- --agent <cursor|claude|agn>
- Selects the backend for the whole pipeline; defaults to cursor.
- -h, --help
- Displays help for the command.
Shorthand forms also appear in help output: --version, --verbose, -v, --help.
Job-control subcommands
- orch list
- Lists all runs tracked under .orch/ in the current directory.
- orch status
- Shows full status for a run; defaults to the most recently started run. Usage: orch status [slug].
- orch pause
- Requests a pause at the run's next stage-boundary checkpoint. Usage: orch pause <slug>.
- orch resume
- Resumes a paused (or pausing) run. Usage: orch resume <slug>.
- orch stop
- Sends SIGTERM to a running job. Usage: orch stop <slug>.
- orch logs
- Prints a run's orch.log; -f follows until terminal state. Usage: orch logs <slug> [-f].
- orch jobs clean
- Deletes every run tracked under .orch/ in the current directory (asks to confirm).
Next → Examples