如何用Agent of Empires组织项目与分组AI代理会话管理完全攻略【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empiresAgent of Empires简称 AoE是一款运行在 Linux 和 macOS 上的AI 代理会话管理器帮你同时管理 Claude Code、OpenCode、Codex CLI、Gemini CLI 等多个 AI 编程代理。它的核心能力是用「项目Project」快速启动会话用「分组Group」归类整理会话让你在 TUI 终端、Web 仪表盘甚至手机浏览器中都能保持井井有条。为什么你需要管理多个AI代理会话当你在多个 Git 仓库、多个分支上并行跑 AI 代理时很快会遇到这三个问题 会话越来越多找不到正在跑哪一个 不同仓库的会话混在一起无法按项目归类 离开电脑后想在手机上看看代理干得怎么样了AoE 的答案是每个代理都运行在独立的 tmux 会话中关闭 TUI、断开 SSH 甚至终端崩溃都不影响它们继续运行重新打开aoe一切都在原地。而在组织层面它提供了项目注册表 分组树 多视图分组三套机制。快速上手安装与启动只需三步# 1. 安装需先安装 tmuxDocker 可选用于沙箱 curl -fsSL https://raw.githubusercontent.com/agent-of-empires/agent-of-empires/main/scripts/install.sh | bash # 或者brew install aoe # 2. 注册一个项目路径只需登记一次 aoe project add /path/to/my-repo # 3. 从该项目启动一个 Claude Code 会话 aoe add /path/to/my-repo -c claude然后运行aoe进入 TUI按?查看完整快捷键。详细步骤见 docs/quick-start.md 与 docs/installation.md。核心概念Project 和 Group 的区别这是新手最容易混淆的两个概念官方文档 docs/quick-start.md 有一句话总结得很好Projects 是会话的起点Groups 是会话存在后的归类方式。概念作用什么时候用操作入口Project项目保存一个仓库目录路径免去重复输入创建会话前aoe project add/ TUI 按p/ Web 侧边栏Group分组给已存在的会话打标签用于侧边栏排序创建会话后aoe group move/ TUI 重命名对话框 / Web 行的 Edit group 菜单项目注册表分两层作用域见 docs/guides/multi-repo-workspaces.md全局app_dir/projects.json所有 profile 可见Profile 级app_dir/profiles/{profile}/projects.json仅当前 profile 可见aoe project list --scope global # 查看全局注册的项目 aoe project add /path/to/repo --name backend # 用短名注册 aoe project remove backend # 移除在 TUI 中注册一个项目后只需按b就能直接从该项目启动新会话n则用于任意路径。会话分组aoe group 四个子命令分组是一棵支持层级的树路径用/表示父子关系例如work/frontend。实现位于 src/cli/group.rs树结构管理在 src/session/groups.rs。四个子命令覆盖了分组的全部生命周期完整参数见 docs/cli/reference.mdaoe group list # 列出所有分组及会话数量 aoe group create backend # 创建顶层分组 aoe group create api --parent backend # 创建子分组 backend/api aoe group move my-session backend # 把会话移入分组 aoe group delete backend # 空分组可直接删除 aoe group delete backend --force # 非空分组会话被移回默认分组几个实用细节️移动即创建aoe group move到不存在的分组时会自动创建它无需先create⚠️删除保护删除含会话的分组默认被拒绝加--force才会把会话移回默认分组️内置特殊分区侧边栏还有系统内置的Archived已归档、Trash回收站和Scratch临时桶用于归档、暂存和无需项目路径的临时会话Web 仪表盘三种分组视角自由切换运行aoe serve启动 Web 仪表盘后左侧工作区侧边栏支持排序与分组两个独立维度详见 docs/guides/web/dashboard.md排序模式三选一Manual默认手动拖拽排序顺序跨浏览器同步Recent activity按最近活动时间排序Attention需要人工介入的会话排最前Waiting、Error 优先分组模式循环切换By repo按仓库分组默认By group按你设置的分组显示未分组的会话沉底By repo and group仓库大标题 内部嵌套分组两层组织在 Web 侧边栏还可以对会话行进行分诊操作右键或触屏长按Pin 置顶让工作区在所有排序模式下浮到最上方Archive 归档停掉该工作区的所有 tmux 会话并沉入折叠脚注发消息可唤醒Snooze 小憩按 1 小时到 1 周的时间窗暂时隐藏支持 Cmd/Ctrl点击多选、Shift点击范围选然后批量置顶或归档——管理几十个并行会话时非常顺手。TUI 中的分组操作速查在 TUI 里常用快捷键一览完整键位按?查看按键操作n新建会话b从已保存项目新建会话p管理已保存项目 / 切换 Project 分组视图g切换分组模式如 Project grouping/搜索会话Ctrlb d从 tmux 会话脱离回到 TUI在 Project 分组视图下把光标放在某个项目标题上按p可以置顶该仓库标题前出现◆标记置顶会写入全局注册表在 Web 端同样生效。进阶多仓库工作区如果一个任务横跨多个仓库比如前后端联调AoE 的多仓库工作区可以为每个仓库创建共享分支名的 worktree挂到同一个 tmux 会话里让一个代理同时驱动所有仓库aoe project add /path/to/backend aoe project add /path/to/frontend aoe add /path/to/backend --project frontend -w feat/auth-rewrite -b完整机制、分支基线与容器行为见 docs/guides/multi-repo-workspaces.md。常见问题 FAQQ关闭 aoe 后会话会消失吗不会。会话就是后台运行的 tmux 会话只有你手动删除才会清理。Q分组和项目会互相影响吗不会。项目决定会话从哪启动分组决定会话怎么展示两者独立可以在 Web 端用By repo and group同时看到两个维度。Q手机上能用吗可以。Web 仪表盘有移动端适配的结构化视图通过aoe serve暴露局域网或隧道访问。Q支持哪些 AI 工具运行aoe agents查看你机器上可用的代理列表包括 Claude Code、OpenCode、Codex CLI、Gemini CLI、Mistral Vibe、Copilot CLI 等。延伸阅读快速上手docs/quick-start.md多仓库工作区docs/guides/multi-repo-workspaces.mdWeb 仪表盘与分组docs/guides/web/dashboard.mdCLI 参考docs/cli/reference.md分组核心实现src/session/groups.rs掌握Project 管启动、Group 管归类、TUI 和 Web 双端同步这三件事你的 AI 代理会话就能像帝国版图一样疆域分明、号令有序。【免费下载链接】agent-of-empiresManage multiple Claude Code, OpenCode agents from either TUI or Web for easy access on mobile. Also supports Mistral Vibe, Codex CLI, Gemini CLI, Pi.dev, Copilot CLI, Factory Droid Coding.项目地址: https://gitcode.com/gh_mirrors/ag/agent-of-empires创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考