核心用法
Agent of Empires (aoe) 是一款专为 AI 编程代理设计的会话管理工具,基于 tmux 构建统一管控层。开发者通过 aoe add 快速启动 Claude Code、OpenCode、Codex 等代理实例,指定项目路径、分组、工作树分支,并可选择 Docker 沙箱或 YOLO 免确认模式。会话支持嵌套分组(如 backend/api)、多 Profile 隔离以及父子会话层级结构。
监控方面,aoe status --json 实时输出等待/运行/空闲/错误等状态聚合;aoe session capture 抓取 tmux 面板内容,便于异步审查代理输出。对于并行开发场景,-w 参数自动创建 Git 工作树,实现多分支代理同时运行而不互相干扰。JSON 格式的输出设计便于与 CI/CD、脚本及 TUI 集成。
显著优点
- 多代理统筹:原生支持 Claude、Codex、OpenCode 等主流工具的统一调度
- 工作流友好:Git 工作树集成实现真正的并行分支开发,无需手动切换
- 可观测性强:结构化状态与捕获接口,易于构建监控仪表盘
- 组织灵活:分组、Profile、父子会话三层结构适应从个人到团队的多种场景
潜在局限
- tmux 依赖:必须预装 tmux,且对 tmux 会话的底层操作有限制
- 生态绑定:针对特定 AI 代理工具优化,通用终端任务管理能力较弱
- 成熟度风险:项目处于早期阶段(GitHub 星标与社区规模尚小),API 稳定性待验证
适合人群
- 需要同时驱动多个 AI 代理处理不同任务或分支的高级开发者
- 追求"异步编码"——让代理在后台运行并定期检视结果的工程师
- 团队协作中希望标准化 AI 代理使用规范的技术负责人
常规风险
- 权限扩散:YOLO 模式 (
-y) 跳过确认提示,可能导致代理执行危险操作 - 沙箱逃逸:Docker 沙箱 (
-s) 的配置与镜像安全性由用户自行保障 - 会话残留:异常退出时 tmux 会话可能残留,需定期
aoe worktree cleanup维护 - 凭证泄露:捕获输出可能包含 API key、token 等敏感信息,需谨慎处理日志