# magents

Connects independent assistant sessions through a shared local bus so tools can exchange context and hand off tasks without manual transcript copying.

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

## What it does

The server exposes a shared API over local disk transcripts produced by tools like Claude Code, Codex, and Cursor. It lets one assistant inspect what another was running, search previous dialog logs via `search_transcripts`, or inject prompts directly into an active thread through `send_message`.

For isolated workflows, `spawn_session` spins up headless background tasks with dedicated directories. Spawned agents strictly retain their host platform's confirmation prompts, which prevents circumventing user approval boundaries during execution.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add magents -- docker run -i --rm ghcr.io/abnegate/magents:0.14.2
```

### Codex

**Platform CLI**
```bash
codex mcp add magents -- docker run -i --rm ghcr.io/abnegate/magents:0.14.2
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "magents": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/abnegate/magents:0.14.2"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "magents": {
            "type": "stdio",
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/abnegate/magents:0.14.2"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add magents docker run -i --rm ghcr.io/abnegate/magents:0.14.2
```

## When to use it
- transfer ongoing branch context directly between different coding tools
- message another active agent session without manually copying errors
- run headless background sessions inside isolated working directories
- search local transcripts across multiple agent workspaces

## Example prompts
- Check current live sessions with magents and pick up the latest task from Codex
- Search past assistant transcripts for mentions of migration errors
- Launch an isolated background session to run tests in a separate folder

## Similar
- [handoff](https://affpapa.org/en/nevibecode/skills/rohitg00-handoff.md) — skill · 13400 installs
- [ctx-purge](https://affpapa.org/en/nevibecode/skills/ctx-purge.md) — skill · 1500 installs
- [browser-login](https://affpapa.org/en/nevibecode/skills/browser-login.md) — skill · 729 installs
- [Session Management](https://affpapa.org/en/nevibecode/skills/session-management.md) — skill · 538 installs
- [half-clone](https://affpapa.org/en/nevibecode/skills/half-clone.md) — skill · ★ 10273
- [Effective Memory](https://affpapa.org/en/nevibecode/skills/effective-memory.md) — skill · ★ 308

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