Agent of Empires Git Worktree完全教程为每个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是一个面向 AI 编码代理的会话管理器支持 Claude Code、OpenCode、Codex CLI、Gemini CLI 等多个代理。它的核心杀手级功能之一就是基于 Git Worktree 为每个 AI 代理自动创建隔离分支和独立代码检出目录——多个代理并行干活互不踩踏。本教程将带你从零开始掌握 Worktree 会话的创建、管理和清理全流程。 为什么 AI 代理需要 Git Worktree想象一下你让 Claude Code 改前端、让 Codex CLI 改后端如果它们共享同一个工作目录git checkout会反复切换分支两个代理的代码互相污染git status一片混乱。Git Worktree 允许同一个仓库同时检出多个分支到不同目录。AoE 把这件事做到了极致✅自动创建新建会话时自动建分支、建目录不用手动敲git worktree add✅自动清理删除会话时连分支和目录一起清掉不留垃圾✅永不碰你的主检出AoE 创建的是新 worktree你在主目录里的未提交改动绝对安全✅多仓库支持一个会话驱动多个仓库共享同一分支名 快速安装 Agent of EmpiresWorktree 功能内置于 AoE 中安装即可用Linux 与 macOS 均支持需先安装 tmux# Homebrew推荐 brew install aoe # 或从源码构建二进制位于 target/release/aoe git clone https://gitcode.com/gh_mirrors/ag/agent-of-empires cargo build --release用aoe --version验证安装详见安装文档。 三种方式创建 Worktree 隔离会话方式一CLI 一行命令创建隔离分支最快捷的方式aoe add加上-wworktree 分支名# 从仓库默认分支新建 feat/my-feature 分支并创建 worktree aoe add . -w feat/my-feature -b # 基于指定基础分支创建无需手动 git fetch远程分支也能直接用 aoe add . -w hotfix-1 -b --base-branch release-1.2 # 附加到已存在的分支-b 是新建 vs 附加的开关 aoe add . -w feat/my-feature创建成功后每个代理会话都拥有独立的目录和分支。-b省略时如果分支已存在则直接附加复用--base-branch会优先匹配远程分支同事还没 fetch 的分支也能直接作为基础。方式二TUI 图形界面勾选 Worktree在 TUI 中按n打开新建会话对话框勾选Worktree复选框即可目录名默认由会话标题自动派生在 Worktree 字段按CtrlP可指定分支名、附加已有分支、选择基础分支或添加额外仓库在 Base 字段按CtrlP打开本地 远程跟踪分支的分支选择器方式三Web 向导手机也能管理运行aoe serve后打开浏览器新建会话向导的More options下有同样的控件基础分支输入框带类型提示和Attach to existing branch开关。手机上也能用结构化视图查看代理进度。️ Worktree 管理命令速查表aoe worktree子命令覆盖了日常管理的全部场景实现见 src/cli/worktree.rs命令作用aoe worktree list列出当前仓库的所有 worktree路径 / 分支 / 类型aoe worktree info session查看会话的分支、worktree 路径、创建时间等详情aoe worktree cleanup找出孤儿 worktree默认 dry-run 只展示aoe worktree cleanup -f真正删除孤儿 worktreeaoe remove session --delete-worktree删除会话时一并清理 worktree小细节aoe worktree cleanup会永久跳过默认分支的检出目录——bare 仓库布局下其他工具依赖它AoE 报告skipped但绝不删除。⚙️ 高级配置路径模板与自动清理在配置文件的[worktree]段可定制行为完整参考见 docs/guides/worktrees.md[worktree] enabled false path_template ../{repo-name}-worktrees/{branch} # 普通仓库 bare_repo_path_template ./{branch} # bare 仓库自动检测 auto_cleanup true # 删除会话时自动清理 worktree delete_branch_on_cleanup false init_submodules true # 新建 worktree 后自动初始化子模块模板变量支持{repo-name}仓库目录名、{branch}斜杠自动转连字符、{session-id}会话 UUID 前 8 位所以../wt/{branch}-{session-id}这类写法完全可行。还有两个贴心的默认行为标题与目录联动重命名会话时worktree 目录跟着git worktree move一起搬家git 分支默认不重命名可能有远端跟踪或 PR可显式开启post-checkout 钩子失败不阻断新建 worktree 时触发的npm install等钩子如果失败只会给出 ⚠ 警告会话照常创建 多仓库工作区一个分支驱动多个仓库当一次改动横跨多个仓库时先用aoe project add注册仓库然后一个会话就能同时驱动它们aoe project add /path/to/backend aoe project add /path/to/frontend aoe add /path/to/backend --project frontend -w feat/auth-rewrite -b会话启动时所有仓库的 worktree 并排放在一个工作区目录下共享feat/auth-rewrite分支名worktree 并行创建耗时取决于最慢的仓库。--repo-base repobranch还能为单个仓库指定不同的基础分支。详细玩法见多仓库工作区指南。 删除会话后Worktree 去哪了这是新手最常问的问题AoE 的答案很优雅删除会话→ 提示是否移除 aoe 管理的 worktree或加--delete-worktree直接删移入回收站→ worktree 被git worktree move搬进.aoe-trash/session-id不再碍事但随时可恢复清空回收站→ 彻底删除默认分支检出→ 任何情况下都不会被删Force也无效手动创建的 worktree 和非 worktree 会话则完全不受影响。 验收 AI 的改动内置 Diff 视图AI 在隔离分支上提交后Web 端可以直接对照基础分支查看逐文件差异无需切回终端敲git diff——这正是隔离分支 可视化评审工作流的完整闭环。 相关资源Worktree 完整参考文档多仓库工作区指南Worktree CLI 命令源码Worktree 创建逻辑源码项目 README总结Agent of Empires 的 Git Worktree 功能让你用一行命令或一次勾选就为每个 AI 代理铺好独立的分支与目录干完活再一键清理——并行跑多个 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），仅供参考