orch agy#

Open agy in your project (interactive)

orch agy [flags]

Starts agy with its normal chat UI in the project for your current folder.

Just run:
  orch agy

Then type your message inside agy — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent agy --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch ask#

Answer blocking questions raised by workers

orch ask [flags]

orch ask answer#

Answer an open ask; the blocked worker resumes immediately

orch ask answer <id> [flags]

orch ask list#

List asks (default: the open ones)

orch ask list [flags]

orch chair#

Configure orchestration guidance for your main (lead) agent session

orch chair [flags]

Optional rules for how the lead session should break work into tasks
and coordinate workers. You can accept or reject each suggestion.

  orch chair setup     # interactive Y/n
  orch chair show
  orch chair install   # write skill/guidance files agents can discover

orch chair install#

Write guidance files + MCP from chair.guidance flags

orch chair install [flags]

orch chair setup#

Suggest guidance flags (Y/n), save orch.yaml, reinstall project files

orch chair setup [flags]

orch chair show#

Show effective chair.guidance flags

orch chair show [flags]

orch claude#

Open claude in your project (interactive)

orch claude [flags]

Starts claude with its normal chat UI in the project for your current folder.

Just run:
  orch claude

Then type your message inside claude — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent claude --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch codex#

Open codex in your project (interactive)

orch codex [flags]

Starts codex with its normal chat UI in the project for your current folder.

Just run:
  orch codex

Then type your message inside codex — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent codex --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch commandcode#

Open commandcode in your project (interactive)

orch commandcode [flags]

Starts commandcode with its normal chat UI in the project for your current folder.

Just run:
  orch commandcode

Then type your message inside commandcode — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent commandcode --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch context#

Configure how large prompts are compressed to save tokens

orch context [flags]

orch context setup#

Suggest context flags (Y/n) and save orch.yaml

orch context setup [flags]

orch context show#

Show effective context.guidance flags

orch context show [flags]

orch copilot#

Open copilot in your project (interactive)

orch copilot [flags]

Starts copilot with its normal chat UI in the project for your current folder.

Just run:
  orch copilot

Then type your message inside copilot — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent copilot --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch cursor#

Open cursor in your project (interactive)

orch cursor [flags]

Starts cursor with its normal chat UI in the project for your current folder.

Just run:
  orch cursor

Then type your message inside cursor — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent cursor --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch daemon#

Background local service for the workspace database (advanced)

orch daemon [flags]

orch discover#

Suggest projects and shared folders from your workspace (you confirm)

orch discover [flags]

orch discover apply#

Confirm proposal into orch.yaml (registers paths only)

orch discover apply [flags]

orch discover run#

Scan workspace and write .orch/discover.proposal.json

orch discover run [flags]

orch discover show#

Print saved discover proposal

orch discover show [flags]

orch dispatch#

Run one agent once without its interactive UI (automation)

orch dispatch [flags]

Runs an agent headlessly with a prompt (CI / scripts).

For the normal interactive agent UI, prefer:
  orch claude | orch opencode | orch commandcode | orch cursor | …

orch gateway login#

experimental

Sign the gateway in to a provider account (only where the provider allows it)

orch gateway login <openai|copilot> [flags]

Experimental — not a product feature. Signs the gateway in with your own plan
so upstream calls are billed to it instead of an API key.

  orch gateway login openai    # ChatGPT/Codex, OAuth PKCE on a loopback callback
  orch gateway login copilot   # GitHub Copilot, device flow (RFC 8628)

Tokens are stored in machine-home with 0600 and never printed. Anthropic is not
offered: claude.ai plan credentials are never collected or intermediated.

orch gateway logout#

experimental

Forget a stored provider account login

orch gateway logout <openai|copilot> [flags]

Experimental — not a product feature. Forgets a stored provider account login.

orch grok#

Open grok in your project (interactive)

orch grok [flags]

Starts grok with its normal chat UI in the project for your current folder.

Just run:
  orch grok

Then type your message inside grok — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent grok --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch guard#

Local guardrail checks

orch guard [flags]

orch guard add-all#

Deny blanket git add (-A/.) when cwd is a shared repo

orch guard add-all [git-command] [flags]

Field lesson: on shared layers, git add -A steals other sessions' WIP.
Pass the shell command (default reads first arg). Soft-skip when cwd is not under a registered shared path.

orch guard artifacts#

Deny disposable build junk (.dcu, .o, .exe, …) beside source

orch guard artifacts [files...|dir] [flags]

Field lesson: compiler outputs next to shared units poison multi-agent floors.
Flags staged paths or walks a directory (skips tests/, out/, build/, .git).
Extensions: .dcu .dcp .o .obj .exe .map .pyc .class .local … and Delphi Unit.pas.~1~ backups.

orch guard code-lang#

Check code identifiers/strings against workspace.code_lang

orch guard code-lang [root] [flags]

Uses workspace.code_lang from orch.yaml (owner decision for shipping code):
  en     — identifiers + user-visible strings in English; comments may be any language
  unset  — skip
  other  — skip until a checker exists

Spanish UI copy belongs in i18n dictionaries (paths like i18n/, es.json are exempt).
Field lesson: chatting in Spanish with the LLM must not put Spanish into identifiers or raises.

orch guard comment#

Deny if exported shared symbols lack a one-line purpose comment

orch guard comment <shared-file> [flags]

orch guard control-bytes#

Deny invisible control bytes in source (except tab/LF/CR)

orch guard control-bytes [files...] [flags]

orch guard ddl#

Require seeder/repository companion for migration/CREATE TABLE changes

orch guard ddl [files...] [flags]

orch guard dup#

Deny if file duplicates a shared symbol; report copied function bodies (clones)

orch guard dup <file> [flags]

orch guard encoding#

Deny missing UTF-8 charset / mojibake in HTML and email templates

orch guard encoding [files...] [flags]

LLMs often forget charset when writing HTML or emails (especially non-English copy).
Checks: meta charset=utf-8 or Content-Type charset=utf-8; classic mojibake patterns (café).
FireDAC / Delphi WideString rules stay workshop-specific — not this gate.

orch guard hooks#

Install git pre-commit/pre-push hooks that run orch guard

orch guard hooks [flags]

orch guard hooks install#

Write .git/hooks/pre-commit + pre-push (orch-marked)

orch guard hooks install [repo] [flags]

orch guard hooks run#

Run pre-commit checks on staged files (used by git hooks)

orch guard hooks run [repo] [flags]

orch guard hooks status#

Show whether orch git hooks are installed

orch guard hooks status [repo] [flags]

orch guard hooks uninstall#

Remove orch-marked pre-commit/pre-push hooks only

orch guard hooks uninstall [repo] [flags]

orch guard ide-hook#

Internal: Claude/Cursor wire entry (soft-skip outside workshop)

orch guard ide-hook [flags]

orch guard lang#

Check workshop docs against workspace.locale

orch guard lang [root] [flags]

Uses workspace.locale from orch.yaml (owner decision for docs/prose):
  en     — deny Spanish markers in docs
  es     — Spanish docs allowed (English-only docs check off)
  unset  — skip

This is separate from workspace.code_lang (see orch guard code-lang).
Chat/docs may be Spanish while code stays English.

orch guard lock#

Deny if shared/** path has no valid lock for --holder

orch guard lock <path> [flags]

orch guard profile#

Show or set guard.profile in orch.yaml

orch guard profile [lite|shared|strict|bring|none] [flags]

orch guard shared-brand#

Deny product brand / products/<id> references inside shared layers

orch guard shared-brand [files...] [flags]

orch guard tracker#

Validate TRACKER state table (T1–T4: status · SPEC · evidence · no prose)

orch guard tracker [TRACKER.md|dir] [flags]

Agnostic checks inspired by workshop field experience:
  T1 — only SPEC|TODO|WIP|DONE|VERIFIED|BLOCKED|DROPPED
  T2 — SPEC rows must point at an existing .md
  T3 — VERIFIED rows need real evidence (not empty/ok/done)
  T4 — table present ⇒ no narrative dump (>12 consecutive prose lines)

Prose-only trackers without a status table soft-skip (exit 0).
When PATH is a directory, walks **/TRACKER.md (bounded).

orch guard unwire#

Remove orch-marked IDE hooks (and optionally git hooks)

orch guard unwire [flags]

orch guard wire#

Install marked git/Claude/Cursor adapters for this workshop

orch guard wire [flags]

orch harness#

Detect AI tools and workshop doctrine surfaces

orch harness [flags]

orch harness scan#

Agents on PATH + Claude/Cursor/OpenCode settings + doctrine files

orch harness scan [flags]

orch hook#

Internal: harness context hooks (Claude Code, OpenCode)

orch hook [flags]

Wired by `orch guard wire`, each gated by its own orch.yaml consent:
  post-tool   Claude Code PostToolUse and OpenCode tool.execute.after
              — context.hooks.post_tool (legacy scalar context.hooks: true)
  pre-compact Claude Code PreCompact — context.hooks.pre_compact
Copilot CLI (postToolUse.modifiedResult) and Cursor (updated_mcp_tool_output)
expose the same capability but orch has no wiring path for either harness yet,
so neither is installed. Codex CLI cannot replace tool output at all.

orch hook post-tool#

Internal: shrink a tool result read from stdin (PostToolUse)

orch hook post-tool [flags]

orch hook pre-compact#

Internal: condense workshop memory before the harness compacts (PreCompact)

orch hook pre-compact [flags]

Runs the same condenser as `orch memory condense` on .workflow/BOARD.md and
.orch/LAST_SESSION.md. Native compaction summarizes the whole transcript and
keeps no original; condensing first means the board survives byte-for-byte in
its `## Clarified` sections and open checkboxes, with the original kept beside
the file. Enabling context.hooks.pre_compact is the owner's standing consent for that.

orch index#

Index shared code into the symbol registry

orch index [flags]

orch index shared#

Scan paths.shared and upsert symbols

orch index shared [flags]

orch inventory#

Check registered shared folders against the symbol index

orch inventory [flags]

orch kimi#

Open kimi in your project (interactive)

orch kimi [flags]

Starts kimi with its normal chat UI in the project for your current folder.

Just run:
  orch kimi

Then type your message inside kimi — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent kimi --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch ledger#

Check the requirements list before spawning lots of work

orch ledger [flags]

orch ledger board#

Print the ledger with (claimed: <session>) next to claimed items (task_claim); never rewrites the file

orch ledger board <file> [flags]

orch ledger check#

Validate ## Clarified + checkbox items (exit 1 on fail)

orch ledger check [dir] [flags]

orch lock#

Lock shared folders so two agents do not edit the same files

orch lock [flags]

orch lock acquire#

Acquire lock on shared path (holder=session id)

orch lock acquire <path> [flags]

orch lock release#

Release lock (holder must match, or --holder *); reindexes symbols + notifies peers

orch lock release <path> [flags]

orch lock status#

Show one lock or list held locks

orch lock status [path] [flags]

orch mcp#

Start the orch tools server for agents (stdio)

orch mcp [flags]

orch memory#

Save and recall durable notes for agents (local)

orch memory [flags]

orch memory condense#

Shrink oversized workshop memory files through the gateway (never automatic)

orch memory condense [flags]

Condenses .workflow/BOARD.md and .orch/LAST_SESSION.md when they pass the size threshold.
`## Clarified` and `## Ownership` sections and every open checkbox item are preserved byte-for-byte —
only narration and finished notes are summarized. The original is kept beside the file.
Requires a running gateway (orch gateway) with a working upstream.

orch memory conflicts#

List active memories with same type+title but different body

orch memory conflicts [flags]

orch memory export#

Export estate as OKF-lite markdown (v0.2-compatible)

orch memory export [dir] [flags]

orch memory forget#

Expire a memory (soft)

orch memory forget <id> [flags]

orch memory import#

Import OKF-lite markdown into the estate

orch memory import [dir] [flags]

orch memory list#

List recent active memories

orch memory list [flags]

orch memory recall#

Search saved memories

orch memory recall [query...] [flags]

orch memory remember#

Store a typed memory

orch memory remember [text...] [flags]

orch memory supersede#

Mark old memory superseded by new id

orch memory supersede <old-id> <new-id> [flags]

orch memory sweep#

Expire memories past retention_days

orch memory sweep [flags]

orch mimo#

Open mimo in your project (interactive)

orch mimo [flags]

Starts mimo with its normal chat UI in the project for your current folder.

Just run:
  orch mimo

Then type your message inside mimo — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent mimo --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch msg#

Send messages between agent sessions

orch msg [flags]

orch msg ack#

Ack message as recipient (session and/or agent must match)

orch msg ack <id> [flags]

orch msg age#

Backdate message created_at (dogfood / tests)

orch msg age <id> [flags]

orch msg gc#

Purge old bus history (acked/unread/log/notices) per bus.* retention

orch msg gc [flags]

orch msg handoff#

Write brief under data/handoffs and send kind=handoff

orch msg handoff [flags]

orch msg inbox#

List messages for session and/or agent

orch msg inbox [flags]

orch msg log#

Show bus activity log (.orch/bus.log)

orch msg log [flags]

orch msg peers#

List other sessions (optional: family view with --session)

orch msg peers [flags]

orch msg read#

Mark message read (legacy; prefer ack)

orch msg read <id> [flags]

orch msg roster#

Show parent/child/sibling sessions for a session

orch msg roster [flags]

orch msg send#

Send a note, handoff, or alert to another session or agent

orch msg send [flags]

orch msg stale#

List unread alerts older than --older-min

orch msg stale [flags]

orch notify-hook#

Command Code hook: drain orch bus/notices → additionalContext JSON (stdout)

orch notify-hook [flags]

orch opencode#

Open opencode in your project (interactive)

orch opencode [flags]

Starts opencode with its normal chat UI in the project for your current folder.

Just run:
  orch opencode

Then type your message inside opencode — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent opencode --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.

orch refine#

Suggest small harness/prompt improvements from recent runs

orch refine [flags]

Looks at recent run evidence and can propose tiny updates to memory
or prompt notes. Default is a dry-run proposal; pass --apply to write.
Undo reverses the last apply. Does not rewrite your core orch.yaml guidance.

orch refine history#

List recent refine events

orch refine history [flags]

orch refine run#

Propose (and optionally apply) refine patches

orch refine run [flags]

orch refine show#

Show supplemental prompt_notes.md

orch refine show [flags]

orch refine undo#

Undo last applied refine (forget memories / strip matching prompt lines)

orch refine undo [flags]

orch resume#

Load a session snapshot from SQLite

orch resume <session-id> [flags]

orch session#

Session commands

orch session [flags]

orch session last#

Print .orch/LAST_SESSION.md (resume card for your last seat)

orch session last [flags]

orch session leadership#

Content-free CTO 1-pager from local gateway usage + session pulses

orch session leadership [flags]

orch session list#

List session snapshots

orch session list [flags]

orch session rename#

Set display name (like claude /rename)

orch session rename <session-id> <name> [flags]

orch session seal#

Write .orch/LAST_SESSION.md from a snapshot (default: newest)

orch session seal [session-id] [flags]

orch symbols#

Query the shared symbol registry

orch symbols [flags]

orch symbols arch#

Directories with symbol counts and the edge counts between them

orch symbols arch [flags]

orch symbols impact#

Symbols in changed files plus their callers (default: the working tree diff)

orch symbols impact [path...] [flags]

orch symbols search#

Search shared symbols

orch symbols search <q> [flags]

orch symbols seed#

Write missing orch:export tags from language AST (bootstrap)

orch symbols seed [path...] [flags]

No args → all shared.<lang> folders. With paths → those folders only.
Idempotent; purpose is always `exported`. Reindexes each rooted folder.

orch symbols snippet#

One symbol body by line range instead of the whole file

orch symbols snippet <symbol> [flags]

orch symbols trace#

Callers and callees of one symbol, with a confidence per edge

orch symbols trace <symbol> [flags]

orch task#

Create and run tasks for worker agents

orch task [flags]

orch task add#

Create a task (optionally pre-assign agent)

orch task add [flags]

orch task assign#

Assign task to an agent

orch task assign <id> <agent> [flags]

orch task claim#

Atomically claim one ledger checklist item (shared_locks key ledger:<path>#<N>)

orch task claim <ledger-file> <item-number> [flags]

orch task done#

Mark task done/failed

orch task done <id> [done|failed] [flags]

orch task list#

List tasks

orch task list [flags]

orch task release#

Release a ledger item claim (holder must match, or --holder *)

orch task release <ledger-file> <item-number> [flags]

orch task run#

Dispatch assigned task (chair → agent session)

orch task run <id> [flags]

orch zcode#

Open zcode in your project (interactive)

orch zcode [flags]

Starts zcode with its normal chat UI in the project for your current folder.

Just run:
  orch zcode

Then type your message inside zcode — do not pass the prompt as orch arguments.
For a one-shot scripted run without the UI, use:
  orch dispatch --agent zcode --prompt "…"

Orche stays underneath (session, tools, locks, gateway when enabled).
One running interactive agent counts as one active seat until you quit.