# Pitroom

Pitroom delegates code reading, fixes, tests, and reviews to worker agents while your main agent keeps going. It returns checked file references, diffs, and token-use receipts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 28
- Author: ATASTECH
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ATASTECH/pitroom
- Updated: 2026-10-19
- HTML: https://affpapa.org/en/nevibecode/mcp/pitroom

## What it does

Pitroom runs worker agents in parallel and sends their findings and exact edits back to the main agent. Delegate code investigation, a change, test checks, or a review while keeping decisions in your primary agent. References formatted as `path:line` are checked against files on disk.

Workers use the default model of their chosen CLI, and a group can combine different CLIs. With `--isolate`, a worker operates on a separate copy of the current state; you can then apply its changes with `pitroom apply <id>` or discard them. Review the diff before applying: conflicting patches are refused.

Pitroom does not commit, push, or reset the repository. In isolation mode, edits stay out of your working tree until you apply them. Install it with `npx`; supported platforms also include Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, and Zed.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add pitroom -- npx -y pitroom
```

### Codex

**Platform CLI**
```bash
codex mcp add pitroom -- npx -y pitroom
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add pitroom npx -y pitroom
```

## When to use it
- delegate file reading to a worker agent
- run separate coding tasks in parallel
- check an agent’s file and line references
- inspect worker edits apart from the main working tree
- collect answers from a group of workers

## Example prompts
- Trace how this request flows through the code and report the relevant files.
- Make this change in isolation and return a diff for review.
- Ask several worker agents to inspect this module, then collect their findings.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

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