Agent of Empires

核心用法

aoe（Agent of Empires）是一款专为 AI 编码代理设计的 tmux 会话管理工具，支持 Claude Code、Codex、OpenCode 等主流 AI 工具。通过 aoe add 创建会话，可指定项目路径、分组、工作树或 Docker 沙箱；aoe list 和 aoe status 实时查看代理运行状态（running/waiting/idle/error）；aoe session capture 捕获终端输出用于审查。支持嵌套分组（如 backend/api）、多 Profile 隔离、YOLO 自动模式，以及 Git 工作树并行开发。

显著优点

• 代理原生设计：相比原始 tmux 命令，aoe 深度理解 AI 代理生命周期，提供状态语义化（waiting/running/idle）
• 并行开发：-w 参数一键创建 Git 工作树，实现多分支隔离的并发代理会话
• 可编程接口：--json 输出全链路支持，便于脚本化监控和 CI/CD 集成
• 安全沙箱：内置 -s Docker 模式与 -y YOLO 权限控制，平衡自动化与安全

潜在局限

• tmux 依赖：必须预先安装 tmux，Windows 原生环境支持有限
• Profile 隔离较弱：多 Profile 切换依赖环境变量或全局参数，无强制权限隔离
• 状态检测非实时：list --json 不包含实时状态，需额外调用 status 或 capture
• TUI 功能集中：批量组操作主要依赖 TUI，纯 CLI 组操作命令较基础

适合人群

• 需要同时管理 3+ AI 代理会话的开发者
• 追求 Git 工作流与 AI 编码深度集成的团队
• 构建 AI 代理自动化流水线（如夜间批处理代码审查）的 DevOps 工程师

常规风险

• YOLO 模式（`-y`） 自动跳过 Claude Code 等工具的权限确认，可能导致意外文件修改或命令执行
• Docker 沙箱（`-s`） 若配置不当，仍可能因卷挂载暴露敏感主机路径
• 工作树残留：--delete-worktree 需显式指定，默认移除会话不会清理 Git 工作树，易造成仓库污染
• tmux 会话泄露：代理异常退出时，底层 tmux 会话可能残留，需定期 aoe worktree cleanup -f 维护