# agent-link

This MCP server lets your primary coding assistant launch, query, and coordinate CLI agents like Codex, Gemini, or Claude Code.

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

## What it does

The server enables two-way collaboration between AI coding tools through terminal subprocesses. When your working agent hits a blocker or needs code review before a merge, it can delegate work to another CLI. The system provides `spawn_agent` for isolated tasks and `spawn_agents` for parallel evaluations across multiple models.

Communication flows in both directions. A spawned subprocess can ask clarifying questions, and the host agent provides answers via `reply`. Each reply executes a fresh CLI command with the conversation history attached rather than resuming a remote session. Active session records live strictly in memory and vanish whenever the MCP server restarts.

Node.js 20 or newer is required. The host cannot spawn secondary agents unless those specific CLIs are already installed and logged in on your machine.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-link -- npx -y agent-link-mcp
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-link -- npx -y agent-link-mcp
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-link npx -y agent-link-mcp
```

## When to use it
- delegate an unresolved error to an alternative agent CLI
- run parallel code reviews across two different models
- pass research findings from one assistant directly into another
- provide answers when a spawned agent asks for guidance

## Example prompts
- Spawn Codex with agent-link to inspect the type errors inside src/utils.ts.
- Run parallel reviews on current git changes using both Claude and Codex.
- Send a reply to agent codex-a1b2c3 confirming that Redis should be used for caching.

## Similar
- [aider-delegate](https://affpapa.org/en/nevibecode/skills/aider-delegate.md) — skill · 3000 installs
- [use-link-identity](https://affpapa.org/en/nevibecode/skills/use-link-identity.md) — skill · 9500 installs
- [arize-link](https://affpapa.org/en/nevibecode/skills/arize-arize-link.md) — skill · 3100 installs
- [link-workspace-packages](https://affpapa.org/en/nevibecode/skills/link-workspace-packages.md) — skill · 3100 installs
- [jetson-link-docs](https://affpapa.org/en/nevibecode/skills/jetson-link-docs.md) — skill · 1100 installs
- [arena](https://affpapa.org/en/nevibecode/skills/arena.md) — skill · 5500 installs

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