# Agents & harnesses

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 |

## Install each harness

### Claude

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

Requires Node.js 18+.

### Codex

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

### Cursor

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

### Kiro

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

### OpenCode

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

### Antigravity

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

### Grok

```bash
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

```bash
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

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

### omp

```bash
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

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

## Using agents in Dispatcher

1. Open **Settings → Harnesses** and confirm the CLI is detected.
2. Create or open a task.
3. Choose an agent and run it. Dispatcher starts the agent in an isolated [git worktree](https://getdispatcher.dev/help/worktrees).
4. 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.

## PATH tips

Dispatcher launches agents from your environment. 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](https://getdispatcher.dev/help/troubleshooting).