核心用法
Agent of Empires (aoe) 是一款专为 AI 编程代理设计的 tmux 会话管理工具，支持 Claude Code、Codex、OpenCode 等多种代理工具的集中化生命周期管理。
会话管理：通过 aoe add 创建带标题、分组、指定工具的代理会话，支持 -l 立即启动、-w 绑定 Git 工作树、-s Docker 沙箱隔离、-y YOLO 免确认模式。会话自动分配 UUID，支持通过 ID 或标题引用。
监控与捕获：aoe session capture 是核心能力，可提取 tmux 面板内容用于状态审查；aoe status --json 提供运行/等待/空闲/停止等聚合统计，便于脚本轮询判断任务完成状态。
组织与隔离：支持嵌套分组（backend/api）、多 Profile 工作区、子会话依赖关系，配合 aoe list --json 实现程序化会话遍历。
显著优点
- 代理原生设计：相比原始 tmux 命令，内置状态语义（running/waiting/idle/stopped/error）和工具元数据
- 并行开发友好：Git 工作树集成实现多分支同时推进，避免切换冲突
- 可编程接口：JSON 输出格式统一，与 jq 配合实现监控脚本自动化
- 环境隔离：Docker 沙箱与 Profile 机制保障多项目、多环境互不干扰
潜在局限
- tmux 强依赖：必须预先安装并运行 tmux 服务
- 生态锁定：主要针对 Claude Code 等特定代理优化，通用进程管理场景非其目标
- TUI 与 CLI 分离：分组批量操作依赖交互式 TUI，纯脚本场景需自行实现循环逻辑
适合人群
- 需要同时管理 3+ 个 AI 编码代理的开发者
- 追求"后台运行、异步审查"工作流的技术团队
- 希望用 JSON API 自动化代理流水线的高级用户
常规风险
- 会话残留：代理异常退出可能导致 tmux 会话僵尸，需定期
aoe worktree cleanup - YOLO 模式：
-y跳过权限确认可能引发意外文件变更 - tmux 配置冲突：用户自定义的 tmux 绑定可能干扰 aoe 的面板捕获
- 工作树膨胀：频繁创建
-w工作树若无--delete-worktree清理，将累积磁盘占用