-**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.**
+**Your agents, your world, in any style you can imagine.**
-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.
+Run Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and your
+own shells side by side in real terminals, and watch every session at work as
+a character in a living 3D world: double-click one to open its real terminal.
+Pick the same live sessions up from your phone, VS Code or any browser. Free,
+on Windows, macOS and Linux.
+
+Agent Guild runs on your computer and serves one local web page. Close the
+page whenever you like; the sessions keep running.
@@ -26,6 +34,8 @@ walk the Yard in your browser. Simulated, free, no account and nothing installed
## Quick start
+**Download the installer.** It brings its own Node.js.
+
@@ -35,23 +45,28 @@ walk the Yard in your browser. Simulated, free, no account and nothing installed
-Or install with npm, on Node.js 22 or newer:
+**Or install it with npm**, on Node.js 22 or newer:
```sh
npm install -g @oddessentials/agent-guild
agent-guild
```
+**Or ask your agent.** Paste this into Claude Code, Codex CLI or any coding agent:
+
+```text
+Set up Agent Guild for me: https://agentguild.oddessentials.ai/agents/
+```
+
+It installs and checks Agent Guild, then connects to it over [MCP](docs/mcp.md)
+to see and steer your sessions. In Claude Code you can also add it as a plugin:
+`claude plugin marketplace add oddessentials/agent-guild --sparse .claude-plugin plugins`,
+then `claude plugin install 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](https://oddessentials.github.io/agent-guild/?view=yard&skin=guild&theme=dark)
-(simulated, nothing installed) or [watch the trailer](https://www.youtube.com/watch?v=_vQuW0v-uMY).
-
-**Or ask your agent.** Point it at
-[the setup skill](https://github.com/oddessentials/agent-guild/blob/main/plugins/agent-guild/skills/setup-agent-guild/SKILL.md),
-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](docs/mcp.md) to see and steer your sessions.
+terminal. [Watch the trailer](https://www.youtube.com/watch?v=_vQuW0v-uMY) to
+see it all at work.
## Why Agent Guild
@@ -69,15 +84,10 @@ then connects over [MCP](docs/mcp.md) to see and steer your sessions.
Codex CLI.
* **The same session on every screen.** Any browser, a phone over
[Tailscale](#remote-access-with-tailscale) with touch keys, VS Code, and
- the Agent Guild app: iPhone, iPad and Apple Vision Pro on the
- [App Store](https://apps.apple.com/us/app/agent-guild-remote/id6825451331);
- Android, Android TV, Google TV and Android XR on
- [Google Play](https://play.google.com/store/apps/details?id=com.oddessentials.agentguild)
- or [GitHub](https://github.com/oddessentials/agent-guild-android/releases/latest);
- Fire tablets and Fire TV on the [Amazon Appstore](https://www.amazon.com/dp/B0HPLBDYPR);
- and Meta Quest on the [Meta Horizon Store](https://www.meta.com/experiences/1325496170657270/).
- Apple Watch and Meta Ray-Ban Display list your sessions and read a
- session's last answer aloud. See [what each screen needs](https://agentguild.oddessentials.ai/requirements/).
+ the Agent Guild app on phones, tablets, TVs and headsets, from the stores
+ above or [GitHub](https://github.com/oddessentials/agent-guild-android/releases/latest)
+ for Android. Apple Watch and Meta Ray-Ban Display list your sessions and
+ read a session's last answer aloud. See [what each screen needs](https://agentguild.oddessentials.ai/requirements/).
* **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
@@ -243,13 +253,6 @@ The first Claude Code usage meter may ask for access to the
-### 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. The clip at the
-top of this page shows it, and [the demo](https://oddessentials.github.io/agent-guild/?view=yard)
-lets you try every skin.
-
Terminal
@@ -263,6 +266,16 @@ lets you try every skin.
+### The Yard
+
+Every session is a character in a living 3D world, one world for each skin.
+Swap in a Yard or theme from the [community](https://github.com/oddessentials/agent-guild-community),
+or make your own with [Agent Guild: Builders](https://github.com/oddessentials/agent-guild-builders)
+and [Agent Guild: Studio](https://github.com/oddessentials/agent-guild-studio). A
+double-click on a character opens its real terminal. The clip at the top of
+this page shows it, and [the demo](https://oddessentials.github.io/agent-guild/?view=yard)
+lets you try every skin.
+
## Commands
| Command | What it does |
@@ -281,10 +294,8 @@ lets you try every skin.
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.
+After an upgrade, refresh every open Agent Guild page: pages reconnect on
+their own but keep running the old page until refreshed.
## Privacy
diff --git a/README.zh-CN.md b/README.zh-CN.md
index f314a6c..a6e01c5 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -1,10 +1,23 @@
-或者用 npm 安裝，需要 Node.js 22 或更新版本：
+**或者用 npm 安裝**，需要 Node.js 22 或更新版本：
```sh
npm install -g @oddessentials/agent-guild
agent-guild
```
-網頁會自動在瀏覽器中開啟。在某個工具的卡片上按 **New** 就能啟動工作階段。
-每個工具在第一個工作階段裡照常登入，和在任何終端機裡一樣。
+**或者交給你的代理。** 把這句話貼給 Claude Code、Codex CLI 或任何程式設計代理：
+
+```text
+Set up Agent Guild for me: https://agentguild.oddessentials.ai/agents/
+```
-**或者交給你的代理。** 讓它讀取
-[安裝技能](https://github.com/oddessentials/agent-guild/blob/main/plugins/agent-guild/skills/setup-agent-guild/SKILL.md)，
它會安裝並檢查 Agent Guild，然後透過 [MCP](docs/mcp.md) 連線，查看並操控你的工作階段。
+在 Claude Code 裡也可以作為外掛加入：
+`claude plugin marketplace add oddessentials/agent-guild --sparse .claude-plugin plugins`，
+然後執行 `claude plugin install agent-guild@agent-guild`。
+
+網頁會自動在瀏覽器中開啟。在某個工具的卡片上按 **New** 就能啟動工作階段。
+每個工具在第一個工作階段裡照常登入，和在任何終端機裡一樣。[觀看預告片](https://www.youtube.com/watch?v=_vQuW0v-uMY)，看看它實際運作的樣子。
## 為什麼選 Agent Guild
@@ -48,11 +70,10 @@ agent-guild
* **所有代理，一處管理。** Claude Code、Codex CLI、Antigravity CLI、Grok Build、
Docker Agent、任何 shell，以及 tmux 或 herdr 工作階段。Claude Code、Codex CLI 和
Grok Build 可以同時登入多個帳號；Claude Code 和 Codex 帳號的用量上限即時可見。
-* **同一個工作階段，每個螢幕。** 任何瀏覽器；透過 Tailscale 在手機上使用，附觸控按鍵；
- VS Code；以及 Agent Guild App：iPhone、iPad 和 Apple Vision Pro（[App Store](https://apps.apple.com/us/app/agent-guild-remote/id6825451331)），
- Android、Android TV、Google TV 和 Android XR（[Google Play](https://play.google.com/store/apps/details?id=com.oddessentials.agentguild)），Fire 平板和 Fire TV
- （[Amazon Appstore](https://www.amazon.com/dp/B0HPLBDYPR)），[Meta Horizon Store](https://www.meta.com/experiences/1325496170657270/)。Apple Watch 和 Meta Ray-Ban Display
- 會列出你的工作階段，並朗讀某個工作階段的最後一則回答。
+* **同一個工作階段，每個螢幕。** 任何瀏覽器；透過 Tailscale 在手機上使用，附觸控按鍵；VS Code；
+ 以及上方各應用程式商店裡適用於手機、平板、電視和頭戴裝置的 Agent Guild App，Android 版也可從
+ [GitHub](https://github.com/oddessentials/agent-guild-android/releases/latest) 取得。
+ Apple Watch 和 Meta Ray-Ban Display 會列出你的工作階段，並朗讀某個工作階段的最後一則回答。
* **Yard：看著它們工作。** 每個工作階段都是 3D 世界裡的一個角色。等你回覆的會被標示出來；
CI 通過時 Yard 會放煙火。雙擊任何一個角色，就能開啟它的真實終端機直接輸入。
* **原生支援 Windows。** 不需要 WSL。也支援 macOS、Linux，以及透過 SSH 使用的無頭 Linux 伺服器。
diff --git a/docs/images/yard-clip.webp b/docs/images/yard-clip.webp
index b162adf..20759be 100644
Binary files a/docs/images/yard-clip.webp and b/docs/images/yard-clip.webp differ
diff --git a/package.json b/package.json
index 799e1aa..f28ee17 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
{
"name": "@oddessentials/agent-guild",
"version": "0.0.0-development",
- "description": "Launch and watch AI coding-assistant terminal sessions from one local web page. A bundled session manager owns the terminals so the page can close and reconnect.",
+ "description": "Run Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent and your shells side by side in real terminals, watch each session as a character in a living 3D world, and pick them up from your phone, VS Code or any browser.",
"mcpName": "ai.oddessentials/agent-guild",
"license": "AGPL-3.0-only",
"repository": {
diff --git a/src/mcp/server.mjs b/src/mcp/server.mjs
index 214a6a2..59c5a2d 100644
--- a/src/mcp/server.mjs
+++ b/src/mcp/server.mjs
@@ -24,7 +24,7 @@ const HIDDEN = '[token hidden]';
// 64 bits of the known token; leave colors, short hashes and 12-digit session ids readable.
const MIN_TOKEN_FRAGMENT = 16;
-const CUSTOMIZE = 'To customize a Yard, the characters and companions of a Yard or Agent Guild: World, or to install Grove Companion on the desktop, follow https://agentguild.oddessentials.ai/agents/.';
+const CUSTOMIZE = 'For ready-made Yards, characters and companions, start with https://github.com/oddessentials/agent-guild-community/discussions. To build your own, or to install Grove Companion on the desktop, follow https://agentguild.oddessentials.ai/agents/.';
const INSTRUCTIONS = `Agent Guild runs coding agents (Claude Code, Codex CLI, Antigravity CLI, Grok Build, Docker Agent) and shells in real terminals on this computer, and opens them on every other screen.
Use guild_status first, list_sessions to see the sessions, read_reply for the answer that ended a session's last turn, and read_screen for what its terminal shows now.
diff --git a/tests/mcp.test.mjs b/tests/mcp.test.mjs
index 01846ca..aca1de9 100644
--- a/tests/mcp.test.mjs
+++ b/tests/mcp.test.mjs
@@ -135,6 +135,7 @@ test('it introduces itself, lists read and write tools, and keeps typing off by
assert.equal(init.result.serverInfo.name, 'agent-guild');
assert.ok(init.result.capabilities.tools);
assert.match(init.result.instructions, /Never ask for, print or store/);
+ assert.ok(init.result.instructions.includes('https://github.com/oddessentials/agent-guild-community/discussions'));
const unknownVersion = await request('initialize', { protocolVersion: '1999-01-01' });
assert.equal(unknownVersion.result.protocolVersion, '2025-11-25');
child.stdin.write('{"jsonrpc":"2.0","method":"notifications/initialized"}\n');
- 
- 
- 
+ 
+ 
+ 
+ 
+ 
+ 
-### 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. The clip at the
-top of this page shows it, and [the demo](https://oddessentials.github.io/agent-guild/?view=yard)
-lets you try every skin.
-
