Agent of Empires 编码代理管理

要解决什么问题

在本地用 Claude Code、Codex、OpenCode 等工具跑编码代理时，进程往往挂在 tmux 里：窗口多了以后，很难一眼分清谁在跑、谁在等输入、项目路径是哪一条。直接用 tmux 命令建窗、抓日志、批量启停，脚本化成本高，也缺少统一的 Session / Group / Profile 抽象。

Agent of Empires（aoe） 把「代理会话」当成一等公民：用 CLI（以及无参启动的 TUI）创建、列出、监控、归档输出，并支持按目录分组和 worktree 并行开发。

核心能力怎么组织

• Session：单个代理进程及其 tmux 会话，带有 ID、标题、工具类型（如 claude）和项目路径；状态包括 running、waiting、idle、stopped、error 等。
• Group：用命名路径（可嵌套，如 backend/api）收纳多路 Session，TUI 里可对整组 bulk start/stop/restart。
• Profile：独立工作区（-p 或环境变量 AGENT_OF_EMPIRES_PROFILE），各自维护会话与配置，适合多项目或多机器习惯切换。
• 可脚本化输出：aoe list --json、aoe status --json、aoe session capture --json 等字段形状固定，便于写监控循环（例如轮询直到没有 running）或事后审阅输出。
• 在 tmux 内可省略标识符：若当前 pane 已在 aoe 管理的会话里，部分命令可自动识别当前 Session。

典型流程包括：单代理起停、多 worktree 并行代理、轮询状态、抓取输出复盘；分组的大规模操作优先走 TUI，流水线则走上述 JSON CLI。

适用边界

本技能面向 AI 编码代理的 tmux 会话管理，不替代与代理无关的通用 tmux 窗格/面板编排。list --json 不含实时状态，需要状态时请用 aoe status --json 或 aoe session capture --json。