Execution modes
Same binary. Five paths — every non---dry-run invocation gets a job record.
| Mode | Behavior | Use when |
|---|---|---|
Default | Triage → quick-fix or full pipeline (research / plan / worktree / test loop / code loop / commit). Always writes a job record (run.json). | Let orch choose the right amount of ceremony. |
--quick | Skips triage; quick-fix edits the current tree. Job record only — no markdown artifacts, worktree, or commits. | You already know it's a tiny, direct edit. |
--ask | Read-only answer printed; no writes to the repo. Job record only. | You want a question answered, not a change. |
--dry-run | Checks the selected agent CLI is on PATH and exits without running the pipeline. Writes nothing under .orch/ — no job record. | Sanity-check your setup before a real run. |
--detach | Full pipeline in the background; prints the slug. Manage with list / status / logs. Writes run.json and orch.log. | Kick off work and keep using your shell (or run several tasks). |
--detach cannot combine with --ask, --quick, or --dry-run. See Headless runs for job-control details.
Next → Headless runs