Headless runs

--detach starts the full pipeline in a background process and returns your shell immediately. Manage runs with the job-control subcommands below.

Start a detached run

orch "implement the local spec" --agent claude --detach
# started <slug> (pid <pid>)

Detached runs write run.json and orch.log under .orch/<slug>/.

Job control

orch list
orch status [slug]
orch pause <slug>
orch resume <slug>
orch logs <slug> [-f]
orch stop <slug>
orch jobs clean

Pause is cooperative

Pause happens at stage boundaries — it is not an OS suspend. A pause requested mid-stage takes effect only once that stage’s agent finishes.

Concurrent detach

Multiple --detach runs can execute concurrently in the same directory, each tracked under its own slug.

Restrictions

Combining --detach with --ask, --quick, or --dry-run is rejected (non-zero exit) — those modes have nothing to background.

Next → CLI reference