# offload

offload is an MCP server for Claude Code that delegates large code-reading tasks to a background CLI agent, returning a short report to the main assistant.

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

## What it does

offload-mcp-server equips your primary coding assistant with tools to hand off file reading, log scanning, and code tree inspection to a background worker agent. The background CLI processes large tasks on its own quota while your main agent retrieves concise summaries and targeted findings with line references. Running the setup utility automatically detects the CLI, registers the server, and configures local files.

Asynchronous execution lets you run multiple background jobs in parallel without blocking your workflow. A built-in dashboard tracks active jobs, opened files, and execution status in real time. Requirements include Node.js 20.3+ and a signed-in Antigravity CLI installation.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add offload-mcp-server -- npx -y offload-mcp-server
```

### Codex

**Platform CLI**
```bash
codex mcp add offload -- npx -y offload-mcp-server
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add offload npx -y offload-mcp-server
```

## When to use it
- offload heavy file reading to a background agent
- gather endpoint inventories without exhausting context
- inspect large code trees asynchronously
- monitor background worker jobs via a live dashboard

## Example prompts
- Inventory every HTTP endpoint under api/ using offload and show me the summary.
- Analyze the log files in the background and return only key errors.
- Run a background scan of the project structure and provide a brief report.

## Similar
- [rust-engineer](https://affpapa.org/en/nevibecode/skills/rust-engineer.md) — skill · 6900 installs
- [nodejs-best-practices](https://affpapa.org/en/nevibecode/skills/nodejs-best-practices.md) — skill · 501 installs
- [async-expert](https://affpapa.org/en/nevibecode/skills/async-expert.md) — skill · 212 installs
- [On-Device Offload](https://affpapa.org/en/nevibecode/agents/on-device-offload.md) — subagent · ★ 41430 repo stars
- [async-api-routes](https://affpapa.org/en/nevibecode/rules/async-api-routes.md) — rule · ★ 7191 repo stars
- [async-defer-await](https://affpapa.org/en/nevibecode/rules/async-defer-await.md) — rule · ★ 7191 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
