AGRO 沙箱运行时
用一个 Docker 沙箱和共享技能，同时治理 Claude Code、Codex、Pi 等多个编码智能体。
- Star 数
- ★ 42
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 49/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经在用 Claude Code 或 Codex，但想让多个智能体在同一项目上并行、互不覆盖工作的开发者。
- 不适合
- 不想在宿主机上安装 Docker 与 Node.js 的个人开发者
- 希望一条命令即用、不愿配置沙箱与工作树流程的团队
- 需要厂商托管 SaaS 而非自行运维沙箱的组织
- 源码审查
- 49/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
AGRO 是一个面向自主编码智能体的治理与运行时编排工具，主体由 agro CLI、一套 Docker 沙箱定义和共享的智能体规程（技能与钩子）组成。它把每个项目装进一个 Docker 沙箱，在沙箱内的 ~/harness 目录中统一管理工具、密钥、harness 与项目克隆。你可以同时运行 Claude Code、Codex、Pi、OpenCode、Hermes、T3 Code 等多个编码 harness，用 git worktree 为并行任务隔离各自的分支与工作文件。工具与 harness 按需安装，agro gateway 还能把 Hermes 或 Pi 接到 Slack。部署边界是你自己的笔记本或远程 VM，前置条件是 Docker（含 Compose 插件）、Git 与 Node.js ≥ 22。
agro CLI 是唯一入口。agro sandbox install docker 通过安装向导创建一个 Docker 沙箱，--checkout 与 --home-mount 可分别绑定项目检出路径与持久化 home 目录；随后 agro shell <name> 进入沙箱。沙箱内 agro tool install/agro tool list 管理 herdr、agent-browser、cloudflared、microsandbox、tailscale、gh、docker-cli 等工具；agro harness install claude-code|codex|pi|opencode|hermes|grok-build|muse-code|antigravity-cli|fx|prime-agent|t3code 安装并启动编码 harness，认证后由 harness 自身完成对话与改代码。共享技能与钩子位于 AGRO 目录布局下，对各家 provider 暴露。agro secret set 以隐藏输入写入令牌，agro gateway hermes|pi 启动对应的 Slack 网关，agro gateway status 查看状态，agro update 与 agro --version 负责升级与版本检查。在 ~/harness 内，智能体按要求把仓库克隆到 projects/，并在 .worktrees/ 下为 issue 建分支与工作树，PR 合并后再清理。
- 已经在用 Claude Code 或 Codex，但想让多个智能体在同一项目上并行、互不覆盖工作的开发者。
- 需要在远程 VM 上跑编码智能体、并希望把项目代码隔离在容器里的团队。
- 希望统一管理多套 harness（Claude Code、Codex、Pi 等）与工具链安装的开发团队。
- 想把 Pi 或 Hermes 接到 Slack，让团队在聊天里触发编码任务的组织。
- 用 VS Code 和 Dev Containers 工作、希望通过「Attach to Running Container」进入沙箱的后端工程师。
- 想先在 GitHub Codespaces 里试用沙箱式智能体工作区的个人开发者。
如何安装或部署这个 Agent？
宿主机需先具备 Docker（含 Compose 插件）、Git 与 Node.js ≥ 22。
通过 npm 全局安装：
npm install -g @mifune/agro或使用 curl 安装脚本（安装到 ~/.local/bin，必要时提示安装 Node.js）：
curl -fsSL https://github.com/mifunedev/agro/releases/latest/download/install.sh | bash检查版本与更新：
agro --version
agro update
agro --help如何使用这个 Agent？
在任意目录创建沙箱并进入（<name> 替换为沙箱名）：
agro sandbox install docker
agro shell <name>沙箱内安装终端工作区与所需工具：
agro tool install herdr
herdr
agro tool list安装并登录一个编码 harness（以 Claude Code 为例）：
agro harness list
agro harness install claude-code
claude auth login
claude auth status
claude可选的 GitHub 认证：
gh auth login
gh auth setup-git
gh auth status可选：用 agro secret set PI_SLACK_APP_TOKEN 等命令保存 Slack 令牌，并用 agro gateway pi 或 agro gateway hermes 启动网关，agro gateway status 查看状态。在 ~/harness 中让智能体克隆项目、创建 worktree 并在合并后清理。
这个 Agent 有哪些优点和局限？
- 提供单一
agroCLI 统一管理沙箱生命周期、工具安装与 harness 安装，避免手工维护容器与工具链。 - 支持 Claude Code、Codex、Pi、OpenCode、Hermes、T3 Code 等十余种 harness 并列运行，可按需切换。
- 用 git worktree 为并行任务隔离分支与文件，文档明确说明智能体不会互相覆盖工作。
- 附带共享技能与钩子、
agro secret隐藏输入保存令牌，以及agro gateway的 Slack 接入。 - 可在本地笔记本或远程 VM 上自托管，并提供 Dev Containers 与 GitHub Codespaces 的接入路径。
- 宿主机必须先安装 Docker（含 Compose 插件）、Git 与 Node.js ≥ 22，环境门槛高于纯 CLI 工具。
- 多数 harness 与可选工具（herdr、agent-browser、tailscale 等）需在沙箱内按需安装并各自认证，首次配置步骤较多。
- 运行时、CLI、容器定义与 harness 规范为 Apache-2.0，但 Mifune Console、控制面与计费/企业策略/RBAC/托管运行为专有，规模化运维受限。
- T3 Code 依赖已认证的 Claude Code、Codex 或 OpenCode provider；Slack 网关需要为每个网关单独创建应用和令牌。
- 文档未给出 Windows 原生支持说明，工作流以 Docker 与 shell 为前提。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AGRO 沙箱运行时 当前 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 42 | 今天 | TypeScript | Codex · Claude Code |
| DevSpace | 50 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 5.3k | 今天 | TypeScript | ChatGPT |
| Gas Town — 多智能体工作区管理器 | 49 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 19k | 1 天前 | Go | Codex · Claude Code |
| Solo Agent | 48 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 594 | 1 个月前 | Go | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
安全文档明确区分 ENFORCED 与 DOCTRINE 边界，并披露 Docker socket、bypassPermissions、cc-safety-net 可被脚本绕过等风险，透明度较好；但默认关闭权限引擎、别名注入 --dangerously-skip-permissions、sudoers ALL=(ALL) ALL、curl|bash 安装、socket 挂载即主机 root，均属高权限默认，扣分明显。回滚方面 agro destroy 无撤销、删除 home 卷，仅 stop 保留，恢复手段薄弱。来源归属仅 README/LICENSE 声明版权，无 NOTICE 或第三方依赖归属清单。
README、quickstart、installation、security 文档在命令、路径、默认值上大体一致，且 CI 有 typecheck/build/test/boot-lint；但部分依赖（agent-browser、ffmpeg、microsandbox 的 KVM）在沙箱内不可用或需额外条件，依赖可用性仅部分保证。失败信息在测试脚本中体现退出码与错误命名，但整体 CLI 失败路径未在证据中充分展示。
面向使用多种编码 harness 的开发者，场景覆盖本地/远程/VM/Codespaces，受众与场景较清晰；但触发精度方面，agent 行为依赖 skill 文本与 doctrine，缺乏确定性触发约束，扣分。环境适配要求 Docker、Node≥22、Linux 主机工具，Windows/macOS 主机工具受限，适配面偏窄。
文档目录、TOC、分主题页面组织良好；安装说明详尽含 PATH、非交互 shell、升级；已知限制在 security 与 microsandbox 文档中明确列出；许可证为完整 Apache-2.0 且说明专有部分。但命名稳定性存在 --repo 弃用别名、CalVer→SemVer 迁移，版本/变更日志仅 SECURITY 提及滚动 SemVer 与仅最新版受支持，无独立 CHANGELOG；维护责任仅指向个人邮箱与未验证发布者，归属不清。
CLI 命令、wizard、harness 安装、worktree 流程输出可用性较好，示例响应具体；但边际价值受限于需 Docker+Node 重环境与大量可选工具，且核心治理多为 doctrine 而非强制，实际增益不确定。成本方面冷构建约十分钟、agent-browser 下载约 1GB、需维护多 harness 认证，成本偏高。
文档引用具体文件路径（hooks、compose、脚本、测试），可追溯性尚可；但多数安全声明为文字描述，未附可复现证据，ADR #1378 仅提及未展示。跨源佐证有限，README 与 security 互相呼应但缺少独立第三方验证。事实与推断分离方面，文档混用 ENFORCED/DOCTRINE 标注较好，但部分能力（如 egress 无绕过）为断言，未在仓库内提供可核验数据。
- 默认关闭权限引擎并注入 --dangerously-skip-permissions，agent 拥有广泛自主权，需自行评估风险。
- Docker socket 挂载等于主机 root，默认关闭但向导可开启，开启后沙箱不再是安全边界。
- cc-safety-net 可被脚本文件绕过，且 Hermes 无 hook/guard，防护不完整。
- agro destroy 无撤销并删除 home 卷（含所有登录与安装），回滚手段有限。
- curl|bash 安装与未验证发布者身份，供应链信任需谨慎。
- 主机级工具（docker-engine、desktop）以 root 安装并修改系统配置，卸载需手工且含破坏性命令。
常见问题
使用 AGRO 需要付费吗？
沙箱里的智能体能访问我的宿主机文件吗？
--checkout 和 --home-mount 显式绑定的，只有绑定进去的路径会暴露。权限与信任边界的细节见文档的 security-considerations。多个智能体同时改同一个项目会互相覆盖吗？
~/harness/projects/<owner>/<repo>/.worktrees/ 下为每个任务创建独立分支与 worktree，工作文件彼此分离，PR 合并后再清理。支持哪些编码 harness？
npx 运行），均可用 agro harness install <id> 安装或启动。可以把它接到 Slack 吗？
xoxb- 与 xapp- 令牌，再用 agro gateway hermes 或 agro gateway pi 启动，并用 agro gateway status 查看状态。