Agent Guild

Agent Guild

在真实终端中并排运行 Claude Code、Codex CLI、Antigravity CLI、Grok Build、Docker Agent 和 你自己的 Shell。你可以通过手机、VS Code 或任何浏览器，继续使用同一批正在运行的会话。在 Windows、macOS 和 Linux 上免费使用。

Agent Guild 是一个运行在你电脑上的轻量管理器，并提供一个本地网页。你可以随时关闭网页；会话仍会继续运行。

快速开始

需要 Node.js 22 或更新版本：

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

网页会在浏览器中打开。点击某个工具卡片上的 New，即可启动会话。在各工具的第一个会话中登录，就像在任何终端中一样。想先看看效果？试用演示（模拟运行，无需安装），或观看预告片。

也可以让你的 Agent 来操作。 将它指向 安装技能， 或运行 claude plugin marketplace add oddessentials/agent-guild --sparse .claude-plugin plugins 和 claude plugin install agent-guild@agent-guild。它会安装并检查 Agent Guild， 然后通过 MCP 连接，以查看和控制你的会话。

为什么选择 Agent Guild

• 原版 CLI，保持不变。 每个会话都在真实终端中运行工具本身，而不是它的聊天副本。工具支持的登录方式都能使用：订阅、API 密钥、Amazon Bedrock 或你自己的网关。
• 所有 Agent 集中管理。 Claude Code、Codex CLI、Antigravity CLI、Grok Build、Docker Agent、任意 Shell，以及 tmux 或 herdr 会话都一目了然。每张卡片都会显示辅助 Agent 和模型，并为 Claude Code 和 Codex CLI 显示用量仪表。
• 在所有屏幕上使用同一会话。 支持任何浏览器、通过 Tailscale 连接并配有触控按键的手机、VS Code，以及适用于 iPhone、iPad 和 Vision Pro（测试版）的应用，还有 Android 应用。 Apple Watch 和 Meta Ray-Ban Display 会列出你的会话，并朗读会话的最后一条回答。
• 原生支持 Windows。 无需 WSL。也支持 macOS、Linux，以及通过 SSH 连接的无头 Linux 服务器。
• 没有中间环节。 无需账号，也没有中继服务：管理器监听 127.0.0.1，其他设备通过你自己的 Tailscale 网络或反向代理连接。请参阅隐私。

对比

	Agent Guild	通过 SSH 使用 tmux	Claude Code Remote Control
Agent	任意命令行工具，可并排使用	任意命令行工具	Claude Code
在手机上使用	在网页或应用中操作真正的终端，并提供触控按键	SSH 应用	Claude 应用中的聊天视图
登录	由工具决定	由工具决定	Pro、Max、Team 或 Enterprise；不支持 API 密钥、Bedrock 或网关
不使用 WSL 的 Windows	支持	不支持	支持

**暂不支持：**推送通知。重新打开手机和 Apple 应用时，它们会重新连接；与此同时，会话会继续在电脑上运行。

**许可证：**基于 GNU AGPL 3.0 开源。可免费用于个人和商业用途。

要求

Node.js	22 或更高版本
Windows	10 版本 1809 或更高版本，x64 或 arm64。无需 WSL。
macOS	11 或更高版本，Intel 或 Apple 芯片
Linux	x64 或 arm64，glibc 2.28 或更高版本（例如 Debian 10、Ubuntu 20.04 或 RHEL 8），可使用桌面环境或通过 SSH 连接

除不带 glibc 的 Linux（例如 Alpine）外，无需编译器：agent-guild 会输出在此类系统上构建其终端库所需的命令。缺少工具时，其卡片上会显示 安装；不在 npm 上的 Antigravity CLI 则会显示其安装命令。如需了解 Docker Agent，请参阅 Docker Agent。

适用于 VS Code 的 Agent Guild 会在编辑器标签页中打开同一页面。从 Open VSX 安装扩展的编辑器可 在此处获取。

设置

访问令牌

无需自行创建。首次运行时会生成令牌，agent-guild 会打开带有该令牌的页面。如果浏览器要求输入令牌，请打开 agent-guild url 输出的链接。任何拥有该链接的人都可以使用你的终端。

如需更换令牌，请停止管理器（这会结束正在运行的会话），从数据文件夹中删除 auth-token，然后重新启动。

Docker Agent

Docker Agent 是 docker agent 插件；Docker Desktop 4.63 及更高版本自带该插件。如果没有正在运行的副本，卡片上的 安装 会将最新版本下载到 ~/.docker/cli-plugins。卡片上的安装框会列出 Docker CLI 检测到的所有副本，并标明正在运行的副本；卡片只会更新和移除下载的副本，而 Docker Desktop 自带的副本则由 Desktop 管理。

在 Linux 上，Docker Engine 不包含该插件；卡片上的 安装 会添加该插件。卡片需要 Docker 自带的 docker 命令：Podman 的 docker 命令和 Ubuntu 的 Docker snap 包都不会加载该插件。如果你通过 Homebrew 或下载发行版，单独安装了名为 docker-agent 的 Docker Agent，请将以下内容添加到 providers.json，然后运行 agent-guild restart：

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

无头 Linux 服务端

1. 在服务端运行：

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

   它会输出 Open: http://127.0.0.1:47821/#token=…。

2. 在你的电脑上打开隧道，并保持隧道运行：

   ssh -L 47821:127.0.0.1:47821 you@server
   

3. 在浏览器中打开输出的链接。本地端口必须为 47821；使用其他端口将被拒绝。

如需在服务端启动时运行 Agent Guild，请在页面中选择 设置 → 启动 → 计算机启动时，然后在服务端运行一次：

sudo loginctl enable-linger $USER

这需要 systemd，且不支持在 WSL 下使用。agent-guild status 会显示结果。

通过 Tailscale 远程访问

在手机或同一 Tailscale 网络中的另一台电脑上使用终端。

你需要使用 Tailscale 1.52 或更高版本，两台设备都登录同一个 tailnet，并启用 MagicDNS。

1. 在页面中，选择 Settings → Remote access → Enable remote access。
2. 如果显示 Open Tailscale approval，请在那里批准 HTTPS，然后选择 Continue setup。
3. 如果显示 Tailscale needs permission，请在有权管理 Tailscale 的终端中运行 Connection details 下的命令，然后选择 Continue setup。
4. 选择 Connect another device，然后在另一台设备上扫描二维码，或打开 登录链接。

登录链接中包含你的访问令牌。选择 Disable remote access 可关闭远程访问；会话仍会继续运行。在无头服务器上，请通过上文的 SSH 隧道执行此操作。有关其他反向代理的信息，请参阅 配置。

macOS 钥匙串

首次使用 Claude Code 用量计量器时，可能会请求访问 “Claude Code-credentials”钥匙串项目。请选择 Always Allow。

功能

• 真正的终端，关闭或重新加载页面后仍会继续运行
• 通过 Split 并排显示两个终端，调整文本大小，并使用 Copy… 选择终端文本
• 适用于手机和平板电脑的触控按键：方向键、Tab、Enter、Esc、Ctrl+C、 Paste 和 Clear
• 在终端中使用 Dictate 语音输入，并使用 Read 大声朗读 Agent 的上一条回答 （Settings → Voice 和 Read aloud）
• 工作文件夹选择器，提供最近使用的文件夹和文件夹浏览器，以及 可在文件管理器中打开该文件夹的按钮
• 从每个工具的卡片安装和更新工具，并从页面升级 Agent Guild
• 每张卡片上显示辅助 Agent 和正在使用的模型 （各工具的设置）
• Claude Code 和 Codex CLI 的速率限制计量器
• 每种工具可使用多个账号（账号）
• 各工具模型的等级和基准测试
• 使用 Existing… 恢复工具的早期会话
• 使用 History 查看 Google 保存的对话，并按工作文件夹筛选
• 使用 Memory 查看 Claude Code、Codex CLI 和 Grok Build 记住的内容，并使用 Instructions 查看它们和 Antigravity CLI 在工作文件夹中读取的指令文件
• GitHub issues、拉取请求、工作流运行、分支和克隆
• Shell 卡片中显示管理器的环境：运行时、设计工具、 Docker，以及项目指定的版本
• 在 Windows、macOS 和 Linux 上登录时启动管理器
• 共享笔记、新闻源、皮肤、浅色和深色模式
• 管理器停止或发现更新时播放警报音
• Videos：Agent Guild 的预告片和教程
• The Yard：将你的工具和会话呈现为 3D 世界，每种皮肤各有一个世界
• tmux 和 herdr 会话，即使管理器停止也会继续运行

### The Yard

为了增添乐趣，Yard 会将你的工具和会话显示为 3D 世界，每种皮肤对应一个世界。双击角色即可打开其真实终端。

终端	继续之前的会话	模型基准测试
新闻	新内容	浅色模式

命令

命令	功能
agent-guild	如有需要，启动管理器并打开页面。--no-browser 会改为打印链接。
agent-guild status	显示管理器是否正在运行，并列出其会话。
agent-guild stop	停止管理器并结束所有会话。
agent-guild restart	使用已安装的版本重启管理器并结束所有会话。
agent-guild url	打印包含访问令牌的页面链接。
agent-guild start	在前台运行管理器。
agent-guild doctor	诊断安装和相关工具的健康状况。
agent-guild mcp	通过 stdio 提供 MCP 服务，以便编码 Agent 查看和控制这些会话。参见 面向 Agent 的 Agent Guild。
agent-guild --version	打印已安装的 Agent Guild 版本（-v 或 version）。

管理器停止或电脑重启时，会话会结束。tmux 和 herdr 会话在管理器停止后仍会保留。

升级 Agent Guild 并重启管理器后，请刷新所有打开的 Agent Guild 浏览器页面，以加载新版前端。页面会自动重新连接，但会继续使用已加载的 JavaScript，直到刷新页面。必须刷新页面，才能与升级后的管理器兼容。

隐私

管理器仅监听 127.0.0.1。远程访问通过专用的 Tailscale 路由，或通过你自己的反向代理访问该地址。这些请求都不会携带你的代码或提示词：

目标	用途	频率
npm registry、Homebrew、GitHub releases（Docker Agent）	版本检查	每小时
Anthropic 和 OpenAI	使用量统计，使用工具自带的登录方式	页面打开期间每分钟
OpenRouter	基准测试的模型列表	每 6 小时
新闻源、Hacker News、arXiv、GitHub	新闻源	页面打开期间每 30 分钟
GitHub releases	新内容	每小时；发布后不久会更频繁
herdr.dev、Homebrew	Multiplexer 版本检查	每小时
GitHub、GitHub Status	GitHub 面板	使用时
软件包源	安装和更新	按需
YouTube	视频缩略图和播放	打开 Videos 时

新闻、模型列表和版本检查失败后，会在 10 分钟后重试。 AGENT_GUILD_NO_UPDATE_CHECK=1 会关闭版本检查和自动升级。

更多

• 面向 Agent 的 Agent Guild：MCP 服务，以及用于配置 Agent Guild 的插件和技能
• 配置：添加工具、账户、环境变量和反向代理
• Agent 报告：显示来自任何工具的 Agent
• 皮肤：打造自己的外观
• 参与贡献

Agent Guild: World

Agent Guild: World 即将登陆 Steam。这是一款独立的高级 3D 窗口，可用于查看同一批会话：包含六个可用自由镜头探索的世界、Steam Workshop 小队和伙伴，以及支持控制器，并可在 Windows、macOS 和 Linux 上运行。Agent Guild 及其 Yard 始终免费。

支持

Agent Guild 可免费使用。如果它为你节省了时间， 请给实验室买杯啤酒。这是一笔小费，并非可抵税的捐赠，也不会对软件产生任何影响。

许可证

版权所有 (c) 2026 Odd Essentials。依据 GNU Affero 通用公共许可证 3.0 授权。