Orch term
Search features…Ctrl K

Flagship features · control plane MCP A2A

Agent orchestration

The AI you're talking to spins up other AIs (claude·codex·agy) as workers and has them collaborate over multiple turns while keeping context. A commander–worker model lets you run a whole team from one place.

What it does

The commander AI launches workers inside orchterm in interactive TUI tabs and exchanges messages with them. It's a bidirectional 1:1 channel where a worker can also speak to the commander first, and no one can touch a worker that isn't their own session — so you can't hijack someone else's work.

commander
External Claude Code
commander
open session
instruct · respond
orchterm
MCP server
:9611
worker tab
return reply
worker
codex · agy · claude
interactive tab

Getting started — put the commander to work

  1. Turn on orchestration

    Turn on orchestration in settings (off by default) and restart the app. After that, an external Claude Code can put workers to work right away with no extra setup.

  2. Delegate from the commander tab

    Delegate in plain language from the commander (claude) tab — a worker tab opens and the reply comes back.

    commander · claudeorchestrating
    commander · claude
    backend · codex
    ask backend(codex) to review the SSH tunnel module ▸ open_session codex from=ep_claude_8f3a… → { session_id: s_4c1e } ▸ send "check whether channel_open_direct_tcpip is concurrency-safe" ⟳ codex working… (waiting for output to idle) ◂ reply codex: "&self borrow ⇒ concurrency-safe. Verified -L/-D listeners bind to 127.0.0.1."
    One cycle: the commander opens a worker, instructs it, and gets a reply.

Supervisor dashboard (one per Space)

Run "Orchestration worker commander" from the command palette to open the supervisor dashboard tab. It gathers the current Space's live sessions in one place, where you can jump to each worker, stop an in-progress turn, and close a session.

Orchestration — supervisor dashboard
Orchestration · Space 1● 2 sessions
codex s_4c1e · ssh-core⟳ turn in progress
agy s_91b7 · docsidle
Status dot — amber in progress · green idle. Jump · stop · close from the row.

What gets exchanged

These are the tools the commander AI calls behind the natural-language layer — you never type them yourself; they're here to help you understand the flow.

ToolWhat it does
list_agentsList of available workers (codex · agy · claude)
open_sessionOpens a worker in an interactive tab
sendInstructs the other side and waits for a reply
close_sessionCloses a worker tab

Safe defaults

Caution — orchestration is a channel through which external programs drive AI locally. Don't carelessly disable the token, local binding, or safe-mode defaults.