# Agent Guild

An MCP server that links an agent to the Agent Guild session manager, letting it view and control terminals for Claude Code, Codex and other CLI tools.

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

## What it does

Agent Guild runs a local manager process and serves a single web page listing sessions for Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and plain shells. Each session is the actual tool running in a real terminal rather than a chat simulation, so whatever sign-in method the tool normally uses, a subscription, an API key, Amazon Bedrock or a custom gateway, keeps working unchanged.

The `agent-guild` MCP server is the bridge an agent uses to talk to that already-running manager: it exposes the session list and lets Claude Code, Codex, Cursor, GitHub Copilot or Gemini CLI steer those terminals directly. The manager itself binds only to `127.0.0.1` with no account and no relay server, so reaching it from another device means setting up your own Tailscale network or reverse proxy.

Running it requires Node.js 22 or newer. Access to the manager's page is gated by a token generated on first launch.

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

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-guild -- npx -y @oddessentials/agent-guild
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-guild -- npx -y @oddessentials/agent-guild
```

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-guild npx -y @oddessentials/agent-guild
```

## When to use it
- connect an agent to live Claude Code and Codex CLI sessions
- switch between several CLI tools from one place
- give an agent control over Docker Agent and shell sessions
- manage sessions without routing data through an external server
- pick up the same sessions later from a phone or browser

## Example prompts
- Connect to Agent Guild and list the active sessions
- Open the Claude Code session through agent-guild and run a command in it
- Check which CLI tools are currently running in Agent Guild

## Similar
- [guild](https://affpapa.org/en/nevibecode/plugins/guild.md) — plugin · ★ 8 repo stars
- [smux](https://affpapa.org/en/nevibecode/skills/smux.md) — skill · 2900 installs
- [control-cli](https://affpapa.org/en/nevibecode/skills/control-cli.md) — skill · 2700 installs
- [cmux-terminal-multiplexer](https://affpapa.org/en/nevibecode/skills/cmux-terminal-multiplexer.md) — skill · 1500 installs
- [cli-for-agents](https://affpapa.org/en/nevibecode/skills/cli-for-agents.md) — skill · 1400 installs
- [cmux-ref](https://affpapa.org/en/nevibecode/skills/cmux-ref.md) — skill · 762 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
