# Scout

Scout routes coding jobs across local harnesses, managing handoffs and execution references through a unified host runtime.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 11 repo stars
- Author: openscout-app
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/openscout-app/scout/tree/HEAD/packages/cli
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/openscout-app-scout

## What it does

Scout acts as a local coordinator for developer assistants such as Claude Code and Codex. Each harness retains its private session context, while the host runtime tracks delegated jobs, returns task handles prefixed with `ref:`, and records incoming replies. You dispatch tasks with `scout ask` and inspect progress using `status` and `wait`.

Jobs run decoupled from the initiating terminal. With the `--notify` option, commands return as soon as the queue accepts work, leaving the caller to poll results via the generated receipt.

Without Bun 1.4.4 or later and an already authenticated harness, Scout cannot dispatch tasks. The software requires Linux or Apple Silicon macOS.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add scout -- npx -y @openscout/scout
```

### Codex

**Platform CLI**
```bash
codex mcp add cli -- npx -y @openscout/scout
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "@openscout/scout"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@openscout/scout"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add cli npx -y @openscout/scout
```

## When to use it
- Route programming chores across separate local harnesses
- Track execution stages through receipt identifiers
- Resume work inside an existing worker session
- Dispatch one-way status notifications without waiting for output

## Example prompts
- Ask Codex to inspect `package.json` and report the package manager
- Check the current execution status of handle `ref:7f3a9c21`
- Follow up on worker `ref:7f3a9c21` to list test commands

## Similar
- [grok-delegate](https://affpapa.org/en/nevibecode/skills/grok-delegate.md) — skill · 4600 installs
- [5dive-cli](https://affpapa.org/en/nevibecode/skills/5dive-cli.md) — skill · 4200 installs
- [warp-delegate](https://affpapa.org/en/nevibecode/skills/warp-delegate.md) — skill · 3100 installs
- [wanman-agent-matrix](https://affpapa.org/en/nevibecode/skills/wanman-agent-matrix.md) — skill · 310 installs
- [proletariat-cli](https://affpapa.org/en/nevibecode/mcp/proletariat-cli.md) — MCP server · ★ 36 repo stars
- [ouraclaw](https://affpapa.org/en/nevibecode/skills/ouraclaw.md) — skill · 692 installs

## Other versions with the same name
- [Scout · klarlabs-studio](https://affpapa.org/en/nevibecode/mcp/klarlabs-studio-scout.md) — ★ 14 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
