核心用法
aoe（Agent of Empires）是一款专为 AI 编码代理设计的会话管理 CLI 工具，构建于 tmux 之上，提供比原生 tmux 更高级的代理生命周期管理能力。
关键功能：
- 会话管理：创建、启动、停止、重启、附加 AI 代理会话，支持自动 ID/标题识别
- 多代理并行：通过 Git worktree 实现同一仓库多分支并行开发，各代理独立运行
- 实时监控：
aoe session capture捕获 tmux 面板内容，aoe status聚合所有代理状态（running/waiting/idle/error） - 组织化分组：支持嵌套分组（如
backend/api）、多 Profile 工作空间隔离 - 工具兼容：内置支持 Claude Code、Codex、OpenCode 等主流 AI 编码工具
典型工作流：
# 启动带 worktree 的并行开发 aoe add . -t "fix-123" -w fix/issue-123 -l aoe status --json | jq '.waiting' # 监控等待队列 aoe session capture "fix-123" -n 50 # 查看输出
显著优点
- 批量操作效率：JSON 输出原生支持管道处理，可编写监控循环批量轮询多个代理
- 环境隔离：Docker 沙盒模式（
-s）和 worktree 机制有效防止代理间状态污染 - 自动化友好：
-q静默模式、--json结构化输出，易于集成 CI/CD 或自定义脚本 - 无头运行：纯 CLI 设计，适合服务器端长期运行的代理任务
潜在局限
- tmux 依赖：必须预装 tmux，Windows 原生环境需 WSL
- 学习曲线：概念层较多（Profile/Group/Worktree），新手易混淆
- TUI 功能分散：分组批量操作主要依赖 TUI，CLI 缺乏一次性群组命令
- 状态延迟：
list --json不含实时状态，需额外调用status或capture
适合人群
- 需要同时管理 3 个以上 AI 代理 的开发者/团队
- 使用 Git worktree 进行多分支并行开发的工程团队
- 追求无头自动化、需将 AI 代理集成到脚本工作流的高级用户
- 对 tmux 熟悉、习惯终端环境的开发者
常规风险
- 权限提升：YOLO 模式（
-y）跳过 AI 代理的权限确认，存在误操作风险 - 资源占用：多 worktree + 多代理并行会显著增加磁盘和内存消耗
- 状态同步：手动
attach进入会话后，外部状态检测可能显示不一致 - 数据残留：
remove --delete-worktree会强制删除 worktree 目录，需谨慎使用