How do I install Agent Guild?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Agent Guild need an API key?

No required environment variable is listed on this record.

What transport does Agent Guild use?

Agent Guild runs locally over stdio.

When was Agent Guild last checked?

Last checked 2026-11-11. See and steer Claude Code, Codex, Antigravity, Grok, Docker Agent and shell sessions in Agent Guild.

Agent Guild MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @oddessentials/[email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add ai.oddessentials-agent-guild -- npx -y @oddessentials/agent-guild@1.31.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.oddessentials-agent-guild": {4      "command": "npx",5      "args": [6        "-y",7        "@oddessentials/[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 1.31.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Agent Guild is a small manager that runs on your computer and serves one local web page. Close the page whenever you like; the sessions keep running.

Quick start

With Node.js 22 or newer:

npm install -g @oddessentials/agent-guild
agent-guild

The page opens in your browser. Press New on a tool's card to start a session. Sign in to each tool inside its first session, as you would in any terminal. To look around first, try the demo (simulated, nothing installed) or watch the trailer.

Or ask your agent. Point it at the setup skill, or run claude plugin marketplace add oddessentials/agent-guild --sparse .claude-plugin plugins and claude plugin install agent-guild@agent-guild. It installs and checks Agent Guild, then connects over MCP to see and steer your sessions.

Why Agent Guild

The real CLIs, unchanged. Each session is the tool itself in a real terminal, not a chat copy of it. Whatever sign-in the tool uses works: a subscription, an API key, Amazon Bedrock or your own gateway.
Every agent in one place. Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent, any shell, and tmux or herdr sessions, each card showing its helper agents and model, with usage meters for Claude Code and Codex CLI.
The same session on every screen. Any browser, a phone over Tailscale with touch keys, VS Code, and apps for iPhone, iPad and Vision Pro (beta) and Android. Apple Watch and Meta Ray-Ban Display list your sessions and read a session's last answer aloud.
Native on Windows. No WSL. Also macOS, Linux, and headless Linux servers over SSH.
Nothing in between. No account and no relay server: the manager listens on 127.0.0.1, and other devices reach it through your own Tailscale network or reverse proxy. See Privacy.

How it compares

	Agent Guild	tmux over SSH	Claude Code Remote Control
Agents	Any CLI, side by side	Any CLI	Claude Code
On a phone	The real terminal in a web page or app, with touch keys	An SSH app	A chat view in the Claude app
Sign-in	Whatever the tool uses	Whatever the tool uses	Pro, Max, Team or Enterprise; not API keys, Bedrock or a gateway
Windows without WSL	Yes	No	Yes

Not yet: push notifications. Phones and the Apple apps reconnect when you open them again; the sessions keep running on the computer in the meantime.

License: open source under the GNU AGPL 3.0. Free for personal and commercial use.

Requirements


Node.js	22 or newer
Windows	10 version 1809 or later, x64 or arm64. No WSL needed.
macOS	11 or later, Intel or Apple silicon
Linux	x64 or arm64 with glibc 2.28 or later (for example Debian 10, Ubuntu 20.04 or RHEL 8), with a desktop or over SSH

No compiler is needed, except on Linux without glibc, such as Alpine: agent-guild prints the commands that build its terminal library there. A missing tool shows Install on its card; Antigravity CLI, which is not on npm, shows its install command instead. For Docker Agent, see Docker Agent.

Agent Guild for VS Code opens the same page in an editor tab. Editors that install from Open VSX get it there.

Setup

Access token

You do not create one. The first run generates it, and agent-guild opens the page with it. If a browser asks for it, open the link that agent-guild url prints. Anyone with that link can use your terminals.

To replace it, stop the manager (this ends running sessions), delete auth-token from the data folder, and start again.

Docker Agent

Docker Agent is the docker agent plugin; Docker Desktop 4.63 and later ship it, and its card's Install downloads the latest release into ~/.docker/cli-plugins when no copy runs. The card's installation box lists every copy the Docker CLI finds and which one runs; the card updates and removes only the downloaded one, and leaves Docker Desktop's to Desktop.

On Linux, Docker Engine does not include the plugin; the card's Install adds it. The card needs Docker's own docker command: Podman's docker and the Ubuntu snap of Docker do not load the plugin. If you installed Docker Agent on its own as docker-agent (Homebrew or a release download), add this to providers.json, then run agent-guild restart:

{ "providers": [{ "id": "docker", "command": "docker-agent", "args": ["run"], "versionArgs": ["version"] }] }

Headless Linux server

On the server:

npm install -g @oddessentials/agent-guild
agent-guild --no-browser

It prints Open: http://127.0.0.1:47821/#token=….

On your computer, open a tunnel and leave it open:
```
ssh -L 47821:127.0.0.1:47821 you@server
```
Open the printed link in your browser. The local port must be 47821; any other port is refused.

To start Agent Guild when the server boots, choose Settings → Startup → When the computer starts in the page, then run once on the server:

sudo loginctl enable-linger $USER

This needs systemd and is not offered under WSL. agent-guild status shows the result.

Remote access with Tailscale

Use your terminals from a phone or another computer on your Tailscale network.

You need Tailscale 1.52 or later, signed in on both devices in the same tailnet, with MagicDNS on.

In the page, choose Settings → Remote access → Enable remote access.
If it shows Open Tailscale approval, approve HTTPS there, then choose Continue setup.
If it says Tailscale needs permission, run the command under Connection details in a terminal allowed to manage Tailscale, then choose Continue setup.
Choose Connect another device and scan the QR code, or open the sign-in link, on the other device.

The sign-in link contains your access token. Disable remote access turns it off; sessions keep running. On a headless server, do this through the SSH tunnel above. For another reverse proxy, see configuration.

macOS keychain

The first Claude Code usage meter may ask for access to the "Claude Code-credentials" keychain item. Choose Always Allow.

Features

Real terminals that survive closing or reloading the page
Two terminals side by side with Split, a text size control, and Copy… to select terminal text
Touch keys for phones and tablets: arrows, Tab, Enter, Esc, Ctrl+C, Paste and Clear
Dictate into a terminal and Read the agent's last answer aloud (Settings → Voice and Read aloud)
A working-folder picker with recent folders and a folder browser, and a button that opens the folder in your file manager
Install and update each tool from its card, and upgrade Agent Guild from the page
Helper agents and the model in use, shown on each card (setup per tool)
Rate-limit meters for Claude Code and Codex CLI
Several accounts per tool (accounts)
Model grades and benchmarks for each tool's models
Resume a tool's earlier sessions with Existing…
Read Google's saved conversations with History, filtered to the working folder
See what Claude Code, Codex CLI and Grok Build remember with Memory, and which instruction files they and Antigravity CLI read in the working folder with Instructions
GitHub issues, pull requests, workflow runs, branches and cloning
The manager's environment on the Shell card: runtimes, design tools, Docker, and the versions a project pins
Start the manager when you sign in, on Windows, macOS and Linux
Shared notes, a news feed, skins, light and dark mode
Alert sounds when the manager stops or an update is found
Videos: Agent Guild's trailers and tutorials
The Yard: your tools and sessions as a 3D world, one for each skin
tmux and herdr sessions that keep running when the manager stops

The Yard

For fun, the Yard shows your tools and sessions as a 3D world, one for each skin. A double-click on a character opens its real terminal.

Commands

Command	What it does
`agent-guild`	Start the manager if needed and open the page. `--no-browser` prints the link instead.
`agent-guild status`	Show whether the manager is running and list its sessions.
`agent-guild stop`	Stop the manager and end every session.
`agent-guild restart`	Restart the manager on the installed version and end every session.
`agent-guild url`	Print the page link with the access token.
`agent-guild start`	Run the manager in the foreground.
`agent-guild doctor`	Diagnose the health of the installation and related tooling.
`agent-guild mcp`	Serve MCP on stdio, so a coding agent can see and steer the sessions. See Agent Guild for agents.
`agent-guild --version`	Print the installed Agent Guild version (`-v` or `version`).

Sessions end when the manager stops or the computer restarts. tmux and herdr sessions survive a manager stop.

After upgrading Agent Guild and restarting the manager, refresh every open Agent Guild browser page to load the new frontend. Pages reconnect automatically, but keep their loaded JavaScript until refreshed. Refreshing is required for compatibility with the upgraded manager.

Privacy

The manager listens on 127.0.0.1 only. Remote access goes through a private Tailscale route or your own reverse proxy to that address. None of these requests carry your code or prompts:

To	For	How often
npm registry, Homebrew, GitHub releases (Docker Agent)	Version checks	Hourly
Anthropic and OpenAI	Usage meters, with the tool's own sign-in	Every minute while the page is open
OpenRouter	Model list for benchmarks	Every 6 hours
News feeds, Hacker News, arXiv, GitHub	News feed	Every 30 minutes while the page is open
GitHub releases	What's new	Hourly, more often just after a release
herdr.dev, Homebrew	Multiplexer version checks	Hourly
GitHub, GitHub Status	GitHub panel	When you use it
Package sources	Installs and updates	When you ask
YouTube	Video thumbnails and playback	When you open Videos

Failed news, model list and release checks retry after 10 minutes. AGENT_GUILD_NO_UPDATE_CHECK=1 turns off version checks and self-upgrade.

Agent Guild for agents: the MCP server, and a plugin and skill that set Agent Guild up
Configuration: add tools, accounts, environment variables, reverse proxies
Agent reporting: show agents from any tool
Skins: make your own look
Contributing

Agent Guild: World

Agent Guild: World, coming soon to Steam, is a separate, premium 3D window onto the same sessions: six worlds to roam with a free camera, Steam Workshop crews and companions, and controller support, on Windows, macOS and Linux. Agent Guild and its Yard stay free.

Support

Agent Guild is free to use. If it saves you time, buy the lab a beer. It is a tip, not a tax-deductible donation, and it changes nothing about the software.

Agent Guild

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Agent Guild?

Does Agent Guild need an API key?

What transport does Agent Guild use?

When was Agent Guild last checked?

Documentation

Quick start

Why Agent Guild

How it compares

Requirements

Setup

Access token

Docker Agent

Headless Linux server

Remote access with Tailscale

macOS keychain

Features

The Yard

Commands

Privacy

More

Agent Guild: World

Support

License