Agent of Empires

核心用法

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 目录，需谨慎使用

核心用法

Agent of Empires (aoe) Skill 是一套围绕 aoe 命令行工具的纯文档化使用指南，旨在帮助开发者在 tmux 环境中高效管理多个 AI 编码代理会话。核心操作包括：

• 会话创建：通过 aoe add 为指定项目目录创建 AI 代理会话，支持自定义标题、分组、工具类型（claude/codex/opencode 等），并可启用工作树模式实现并行分支开发或 Docker 沙箱隔离
• 生命周期管控：提供 start/stop/restart/attach 等完整会话控制能力，支持从当前 tmux 窗格自动检测会话上下文
• 状态监控：通过 aoe status --json 获取实时状态统计（waiting/running/idle/stopped/error），配合 session capture 提取终端输出内容，便于异步审查代理执行结果
• 组织管理：支持嵌套分组（如 backend/api）、多配置文件（profile）隔离、会话重命名与批量迁移

典型工作流

单代理模式：快速启动 → 等待完成 → 捕获输出审查
并行开发模式：利用 Git worktree 同时运行多个分支的 AI 代理，统一监控状态
自动化巡检：结合 jq 解析 JSON 输出，构建轮询脚本直至所有代理 idle

显著优点

1. 零代码执行风险：纯 Markdown 文档型 Skill（T-MD），无可执行脚本，安全边界清晰
2. 来源可信：由 GitHub Organization agent-of-empires 维护，T2 级可信来源，具备明确官方主页
3. 多工具兼容：统一接口管理 Claude Code、Codex、OpenCode 等主流 AI 编程助手
4. 工程化友好：完整的 JSON 输出支持、状态机设计、Git worktree 原生集成，契合现代开发工作流
5. 灵活的权限控制：支持 YOLO 模式跳过确认提示，也保留标准交互模式满足不同安全偏好

潜在局限

1. 外部依赖必需：必须预装 aoe CLI 和 tmux，Skill 本身不提供功能实现，仅作调用文档
2. 无可视化界面：CLI 为主的交互方式，分组批量操作依赖 TUI（需单独运行 aoe 无参命令）
3. 许可证未声明：当前版本未明确开源协议，存在轻微合规不确定性
4. 版本耦合风险：Skill 文档与 aoe CLI 功能演进可能存在版本错位

适合人群

• 需要同时管理 3 个以上 AI 编码代理 的全栈开发者
• 采用 Git worktree 并行开发策略 的技术团队
• 追求 tmux 原生体验、偏好命令行工作流的资深工程师
• 需要 自动化 CI/CD 集成 AI 代码审查或批量重构的 DevOps 工程师

使用风险

1. 供应链风险：aoe CLI 本身的安全更新依赖外部维护者，建议建立独立监控机制
2. 终端状态漂移：capture 命令获取的是 tmux pane 文本快照，非结构化日志，可能存在 ANSI 转义序列处理边界问题
3. 资源占用：多会话并行运行 AI 代理对本地计算资源消耗显著，需合理规划并发数
4. profile 数据隔离：跨 profile 会话默认不可见，误操作可能导致配置分散或重复创建