如何用Agent of Empires并行管理多个代码仓库多仓库工作区完整指南【免费下载链接】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是一款开源的 AI 编码代理会话管理工具支持在 TUI 或 Web 端并行运行 Claude Code、OpenCode、Codex CLI、Gemini CLI 等多个代理。其中最实用的能力之一是多仓库工作区Multi-Repo Workspaces让一个 AI 代理同时驱动多个代码仓库每个仓库自动获得独立的 Git worktree共享同一个分支名全部挂在同一个会话下——非常适合跨仓库协作开发如后端 前端 公共库一起改。什么是多仓库工作区传统做法中一个特性横跨 3 个仓库时你需要手动在 3 个终端窗口间切换、手动同步分支名、手动协调提交。多仓库工作区把这个流程收敛成一个会话每个仓库各建一个worktree独立的分支检出目录全部使用同一个分支名如feat/auth-rewrite所有 worktree 作为兄弟目录挂在同一个工作区目录下例如~/aoe-workspaces/feat-auth-rewrite/ ├── backend/ ← 分支 feat/auth-rewrite ├── frontend/ ← 分支 feat/auth-rewrite └── shared-lib/ ← 分支 feat/auth-rewrite整个工作区只绑定一个 tmux 会话AI 代理用普通的cd和 git 命令在各仓库间自由穿梭无需任何额外编排。几个关键特性⚡并行创建worktree 并发创建总耗时约等于最慢的那个仓库而不是所有仓库之和容错某个仓库的 post-checkout 钩子失败或 fetch 失败只产生警告不会中断整个工作区️安全AoE 只创建 worktree绝不触碰你正在使用的原始检出目录。30 秒快速上手创建第一个多仓库会话整个流程只有两步先注册仓库再启动会话。第 1 步注册仓库只需一次aoe project add /path/to/backend aoe project add /path/to/frontend第 2 步指定多个仓库启动会话aoe add /path/to/backend --project frontend --project shared-lib \ -w feat/auth-rewrite -b其中-w指定工作分支名-b表示新建分支。会话启动后所有仓库的 worktree 就齐了。Web 仪表盘侧边栏会按仓库分组展示会话多仓库会话统一归入底部的Multi-repo分组每行用徽章chip标注涉及的仓库。项目注册表管理你的多仓库清单aoe project add写入的是项目注册表Project Registry它是各选择器picker的数据源分两个作用域作用域存储文件可见范围全局globalapp_dir/projects.json所有 profile档案profileapp_dir/profiles/{profile}/projects.json仅该 profile常用命令aoe project list # 默认合并显示两个作用域 aoe project add /path/to/repo --name shortname aoe project remove backend # 按名称或规范路径删除两个容易混淆的概念注册registry让仓库出现在选择器里与是否有会话无关固定pinning让项目在侧边栏始终显示标题行即使零会话。取消固定不会删除注册条目只有aoe project remove会真正删除。注册表实现位于 src/session/projects.rs支持按名称或规范路径去重跨作用域重复注册默认报错可用--allow-override让 profile 条目覆盖全局条目。三种方式创建多仓库会话除了 CLITUI 和 Web 也提供完整的图形化入口界面操作CLI--repo字面路径与--project注册名可混用重名仓库会被直接拒绝TUI新建会话对话框中聚焦Extra Repos字段按CtrlR从注册表中勾选项目也可在首页按b直接打开注册表选择器Web向导中选好主仓库后在Extra repos选择器点击项目徽章或直接粘贴未注册的路径给已有会话追加仓库多仓库工作区不是一次性的——随时可以往运行中的会话里加仓库aoe session add-project session frontendTUI 和 Web 中则右键会话选择Add project或用命令面板执行。追加后的会话与一开始就用--project创建的会话完全等价aoe list --json会在workspace_repos中列出全部仓库。不同起点会发生什么会话类型追加后工作目录已是多仓库工作区新仓库的 worktree 直接并入不变worktree 会话新建工作区原 worktree 移入未提交的改动会跟随移动原址会话新建工作区并为该仓库创建全新worktree移动⚠️ 注意目录会移动时会话会被停止并重启正在对话中途mid-turn追加会被拒绝。若新仓库不存在该分支名AoE 会从它自己的 base 分支创建若分支已存在则拒绝追加同名分支可能含无关提交除非显式勾选Attach to existing branch。每个仓库使用不同 base 分支默认所有仓库都从--base-branch派生分支。如果某个仓库要从develop或特性大分支出发用--repo-base单独指定aoe add /path/to/backend --project frontend \ -w feat/auth-rewrite -b --base-branch develop \ --repo-base frontendepic/checkout每个仓库实际派生自的 base 分支会成为该仓库diff 视图的默认对比基准之后也可用aoe session set-base --repo name调整。详见 docs/guides/diff-view.md。在 Web 端右侧面板会列出所有变更文件及增删行数点开即可逐行审查 AI 在各仓库中的修改下方还有配对的 Shell 终端方便随时手动验证。自动清理分支与 worktree 的生命周期多仓库工作区的清理与单仓库一致删除会话时会提示移除 AoE 托管的 worktreeaoe remove session --delete-worktree aoe worktree list # 查看所有 worktree aoe worktree cleanup # 找出孤立的 worktree安全机制值得放心️移入回收站worktree 会被git worktree move到.aoe-trash/下的保留目录可随时恢复️默认分支的检出永远不会被删除包括 bare 仓库布局中的默认分支强制删除也不例外完整的生命周期规则见 docs/guides/worktrees.md。进阶技巧用仓库钩子自动化环境准备如果每个仓库在创建会话后都要跑npm install、docker-compose up之类的准备步骤可以把命令写进仓库内的.agent-of-empires/config.toml团队成员共用[hooks] on_create [npm install, cp .env.example .env] on_launch npm install on_destroy [docker-compose down]首次遇到仓库钩子时 AoE 会要求你审查并信任防止陌生仓库执行任意命令CI 场景可用aoe add --trust-hooks .跳过。详见 docs/guides/repo-config.md。对于固定的兄弟仓库组合on_create钩子甚至比工作区更简单。已知限制与最佳实践当前限制来自官方文档一个工作区只有一个分支名所有仓库共享-w branchAI 代理不能给自己的会话添加仓库追加仓库可能重启代理且不保证对话连续暂无工作区模板也没有按仓库的 PR 跟踪。最佳实践✅ 把常用仓库全部注册进项目注册表命名简短如backend、fe创建会话时效率翻倍✅ 用--repo-base为每个仓库指定贴合其开发流程的 base 分支✅ 仓库配置了post-checkout钩子的注意网络/凭证问题只会产生警告环境就绪后手动重跑即可✅ 原址会话in-place在追加仓库前先提交或 stash 未提交的改动否则会被拒绝✅ 用 Web 端Multi-repo分组统一查看跨仓库会话状态配合 docs/guides/web/dashboard.md 中的排序与分组能力做任务分诊。相关资料多仓库工作区完整文档docs/guides/multi-repo-workspaces.mdworktree 参考docs/guides/worktrees.md仓库级配置与钩子docs/guides/repo-config.md注册表源码src/session/projects.rsworktree 创建逻辑src/git/worktree/create.rs添加会话命令src/cli/add.rs掌握多仓库工作区后你可以把跨 3 个仓库重构认证这类任务交给一个代理一气呵成然后泡杯茶回到仪表盘验收成果。【免费下载链接】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），仅供参考
如何用Agent of Empires并行管理多个代码仓库：多仓库工作区完整指南
如何用Agent of Empires并行管理多个代码仓库多仓库工作区完整指南【免费下载链接】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是一款开源的 AI 编码代理会话管理工具支持在 TUI 或 Web 端并行运行 Claude Code、OpenCode、Codex CLI、Gemini CLI 等多个代理。其中最实用的能力之一是多仓库工作区Multi-Repo Workspaces让一个 AI 代理同时驱动多个代码仓库每个仓库自动获得独立的 Git worktree共享同一个分支名全部挂在同一个会话下——非常适合跨仓库协作开发如后端 前端 公共库一起改。什么是多仓库工作区传统做法中一个特性横跨 3 个仓库时你需要手动在 3 个终端窗口间切换、手动同步分支名、手动协调提交。多仓库工作区把这个流程收敛成一个会话每个仓库各建一个worktree独立的分支检出目录全部使用同一个分支名如feat/auth-rewrite所有 worktree 作为兄弟目录挂在同一个工作区目录下例如~/aoe-workspaces/feat-auth-rewrite/ ├── backend/ ← 分支 feat/auth-rewrite ├── frontend/ ← 分支 feat/auth-rewrite └── shared-lib/ ← 分支 feat/auth-rewrite整个工作区只绑定一个 tmux 会话AI 代理用普通的cd和 git 命令在各仓库间自由穿梭无需任何额外编排。几个关键特性⚡并行创建worktree 并发创建总耗时约等于最慢的那个仓库而不是所有仓库之和容错某个仓库的 post-checkout 钩子失败或 fetch 失败只产生警告不会中断整个工作区️安全AoE 只创建 worktree绝不触碰你正在使用的原始检出目录。30 秒快速上手创建第一个多仓库会话整个流程只有两步先注册仓库再启动会话。第 1 步注册仓库只需一次aoe project add /path/to/backend aoe project add /path/to/frontend第 2 步指定多个仓库启动会话aoe add /path/to/backend --project frontend --project shared-lib \ -w feat/auth-rewrite -b其中-w指定工作分支名-b表示新建分支。会话启动后所有仓库的 worktree 就齐了。Web 仪表盘侧边栏会按仓库分组展示会话多仓库会话统一归入底部的Multi-repo分组每行用徽章chip标注涉及的仓库。项目注册表管理你的多仓库清单aoe project add写入的是项目注册表Project Registry它是各选择器picker的数据源分两个作用域作用域存储文件可见范围全局globalapp_dir/projects.json所有 profile档案profileapp_dir/profiles/{profile}/projects.json仅该 profile常用命令aoe project list # 默认合并显示两个作用域 aoe project add /path/to/repo --name shortname aoe project remove backend # 按名称或规范路径删除两个容易混淆的概念注册registry让仓库出现在选择器里与是否有会话无关固定pinning让项目在侧边栏始终显示标题行即使零会话。取消固定不会删除注册条目只有aoe project remove会真正删除。注册表实现位于 src/session/projects.rs支持按名称或规范路径去重跨作用域重复注册默认报错可用--allow-override让 profile 条目覆盖全局条目。三种方式创建多仓库会话除了 CLITUI 和 Web 也提供完整的图形化入口界面操作CLI--repo字面路径与--project注册名可混用重名仓库会被直接拒绝TUI新建会话对话框中聚焦Extra Repos字段按CtrlR从注册表中勾选项目也可在首页按b直接打开注册表选择器Web向导中选好主仓库后在Extra repos选择器点击项目徽章或直接粘贴未注册的路径给已有会话追加仓库多仓库工作区不是一次性的——随时可以往运行中的会话里加仓库aoe session add-project session frontendTUI 和 Web 中则右键会话选择Add project或用命令面板执行。追加后的会话与一开始就用--project创建的会话完全等价aoe list --json会在workspace_repos中列出全部仓库。不同起点会发生什么会话类型追加后工作目录已是多仓库工作区新仓库的 worktree 直接并入不变worktree 会话新建工作区原 worktree 移入未提交的改动会跟随移动原址会话新建工作区并为该仓库创建全新worktree移动⚠️ 注意目录会移动时会话会被停止并重启正在对话中途mid-turn追加会被拒绝。若新仓库不存在该分支名AoE 会从它自己的 base 分支创建若分支已存在则拒绝追加同名分支可能含无关提交除非显式勾选Attach to existing branch。每个仓库使用不同 base 分支默认所有仓库都从--base-branch派生分支。如果某个仓库要从develop或特性大分支出发用--repo-base单独指定aoe add /path/to/backend --project frontend \ -w feat/auth-rewrite -b --base-branch develop \ --repo-base frontendepic/checkout每个仓库实际派生自的 base 分支会成为该仓库diff 视图的默认对比基准之后也可用aoe session set-base --repo name调整。详见 docs/guides/diff-view.md。在 Web 端右侧面板会列出所有变更文件及增删行数点开即可逐行审查 AI 在各仓库中的修改下方还有配对的 Shell 终端方便随时手动验证。自动清理分支与 worktree 的生命周期多仓库工作区的清理与单仓库一致删除会话时会提示移除 AoE 托管的 worktreeaoe remove session --delete-worktree aoe worktree list # 查看所有 worktree aoe worktree cleanup # 找出孤立的 worktree安全机制值得放心️移入回收站worktree 会被git worktree move到.aoe-trash/下的保留目录可随时恢复️默认分支的检出永远不会被删除包括 bare 仓库布局中的默认分支强制删除也不例外完整的生命周期规则见 docs/guides/worktrees.md。进阶技巧用仓库钩子自动化环境准备如果每个仓库在创建会话后都要跑npm install、docker-compose up之类的准备步骤可以把命令写进仓库内的.agent-of-empires/config.toml团队成员共用[hooks] on_create [npm install, cp .env.example .env] on_launch npm install on_destroy [docker-compose down]首次遇到仓库钩子时 AoE 会要求你审查并信任防止陌生仓库执行任意命令CI 场景可用aoe add --trust-hooks .跳过。详见 docs/guides/repo-config.md。对于固定的兄弟仓库组合on_create钩子甚至比工作区更简单。已知限制与最佳实践当前限制来自官方文档一个工作区只有一个分支名所有仓库共享-w branchAI 代理不能给自己的会话添加仓库追加仓库可能重启代理且不保证对话连续暂无工作区模板也没有按仓库的 PR 跟踪。最佳实践✅ 把常用仓库全部注册进项目注册表命名简短如backend、fe创建会话时效率翻倍✅ 用--repo-base为每个仓库指定贴合其开发流程的 base 分支✅ 仓库配置了post-checkout钩子的注意网络/凭证问题只会产生警告环境就绪后手动重跑即可✅ 原址会话in-place在追加仓库前先提交或 stash 未提交的改动否则会被拒绝✅ 用 Web 端Multi-repo分组统一查看跨仓库会话状态配合 docs/guides/web/dashboard.md 中的排序与分组能力做任务分诊。相关资料多仓库工作区完整文档docs/guides/multi-repo-workspaces.mdworktree 参考docs/guides/worktrees.md仓库级配置与钩子docs/guides/repo-config.md注册表源码src/session/projects.rsworktree 创建逻辑src/git/worktree/create.rs添加会话命令src/cli/add.rs掌握多仓库工作区后你可以把跨 3 个仓库重构认证这类任务交给一个代理一气呵成然后泡杯茶回到仪表盘验收成果。【免费下载链接】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），仅供参考
