Agent Guild

Agent Guild

English · 简体中文 · 繁體中文

Run Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and your own shells side by side in real terminals. Pick the same live sessions up from your phone, VS Code or any browser. Free, on Windows, macOS and Linux.

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.

[Try the demo](https://oddessentials.github.io/agent-guild/?view=yard&skin=guild&theme=dark): walk the Yard in your browser. Simulated, free, no account and nothing installed.

Quick start

On Linux, extract the download and run ./install.sh . · macOS on Intel · All downloads and checksums

Or install with npm, on 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 the Agent Guild app: iPhone, iPad and Apple Vision Pro on the App Store; Android, Android TV, Google TV and Android XR on Google Play or GitHub; Fire tablets and Fire TV on the Amazon Appstore; and Meta Quest on the Meta Horizon Store. Apple Watch and Meta Ray-Ban Display list your sessions and read a session's last answer aloud. See what each screen needs.
• 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

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

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](https://marketplace.visualstudio.com/items?itemName=OddEssentials.agent-guild) 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

1. On the server:

   npm install -g @oddessentials/agent-guild

agent-guild --no-browser

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

1. On your computer, open a tunnel and leave it open:

   ssh -L 47821:127.0.0.1:47821 you@server

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

1. In the page, choose Settings → Remote access → Enable remote access.
2. If it shows Open Tailscale approval, approve HTTPS there, then choose Continue setup.
3. If it says Tailscale needs permission, run the command under Connection details in a terminal allowed to manage Tailscale, then choose Continue setup.
4. Choose Connect another device and scan the QR code, or open the sign-in link, on the other device. On a TV or another device without a camera, enter your remote address in the Agent Guild app and approve the code it shows.

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