Agents & harnesses · Dispatcher Docs

Canonical HTML: https://getdispatcher.dev/help/agents

Dispatcher is harness-agnostic: it runs coding-agent CLIs you already use. Agents execute on your machine with your credentials. Install a CLI, keep it on your PATH, then log in from Settings → Harnesses or your terminal.

Supported agents

Agent	CLI	Login command	Docs
Claude	`claude`	`claude /login`	https://docs.anthropic.com/en/docs/claude-code/overview
Codex	`codex`	`codex login`	https://github.com/openai/codex
Cursor	`cursor-agent`	`cursor-agent login`	https://docs.cursor.com/en/cli/overview
Kiro	`kiro-cli`	`kiro-cli login`	https://kiro.dev/docs/cli/
OpenCode	`opencode`	`opencode auth login`	https://opencode.ai/docs/
Antigravity	`agy`	`agy login`	https://antigravity.google/
Grok	`grok`	`grok login`	https://x.ai/cli
Muse Code	`muse`	`muse login`	https://developer.meta.com/ai/products/muse-code/
Pi	`pi`	`pi /login`	https://pi.dev
omp	`omp`	`omp /login`	https://omp.sh
Hermes	`hermes`	`hermes setup`	https://hermes-agent.nousresearch.com
Poolside	`pool`	`pool login`	https://docs.poolside.ai/tools/other-acp

Install each harness

Claude

npm install -g @anthropic-ai/claude-code
claude --version
claude /login

Requires Node.js 18+.

Codex

npm install -g @openai/codex
# or: brew install codex
codex login

Cursor

curl https://cursor.com/install -fsS | bash
# restart your shell
cursor-agent --version
cursor-agent login

Kiro

curl -fsSL https://kiro.dev/install.sh | bash
# restart your shell
kiro-cli --version
kiro-cli login

OpenCode

curl -fsSL https://opencode.ai/install | bash
# or: npm install -g opencode-ai
opencode auth login

Antigravity

Download Antigravity and enable the agy CLI from the product docs.
Verify: agy --version
Log in: agy login

Grok

curl -fsSL https://x.ai/cli/install.sh | bash
# or: npm install -g @xai-official/grok
# restart your shell
grok version
grok login

Muse Code

curl -fsSL https://dev.meta.ai/install.sh | bash
# restart your shell
muse --version
muse login

Official install scripts currently target macOS/Linux for Muse; check Meta’s docs for Windows status.

Pi

npm install -g --ignore-scripts @earendil-works/pi-coding-agent
# or: curl -fsSL https://pi.dev/install.sh | sh
pi --version
pi /login

omp

curl -fsSL https://omp.sh/install | sh
# or: bun install -g @oh-my-pi/pi-coding-agent
# restart your shell
omp --version
omp /login

Hermes

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
# restart your shell
hermes --version
hermes setup

Poolside

curl -fsSL https://downloads.poolside.ai/pool/install.sh | sh
# restart your shell
pool --version
pool login

ACP-compatible editors can also point at pool acp. See https://docs.poolside.ai/tools/other-acp.

Using agents in Dispatcher

Open Settings → Harnesses and confirm the CLI is detected.
Create or open a task.
Choose an agent and run it. Dispatcher starts the agent in an isolated git worktree.
Watch the terminal tab, review the diff, then open a pull request when ready.

You can run multiple agents of different types in the same workspace and switch between their terminal tabs.

Side-by-side agents

To compare two agents (any supported harness) at once:

Open at least two agent tabs in the workspace.
Shift+click a second agent (or terminal) tab to open it beside the current one.
Drag the divider to resize. Click a pane to focus it for typing.
Click Unsplit in the tab bar to return to a single pane.

Diff, Code, History, and other non-terminal tabs still take the full panel when selected.

PATH tips

Dispatcher resolves harness CLIs from your login-shell PATH, npm global bin dir, ~/.local/bin, nvm, Homebrew, and other common install locations — then launches agents by absolute path, so a broken terminal PATH (e.g. npm_config_prefix without ~/.local/bin) usually still works inside Dispatcher.

If a harness shows as missing:

Restart Dispatcher after installing a CLI
Confirm the binary works in a normal terminal (which claude, codex --version, etc.)
On macOS GUI apps, ensure the install location is on the PATH Dispatcher inherits (Homebrew paths are a common miss)

More fixes: Troubleshooting.