用途:gwt(Git Worktree Manager)用集中式 worktrees/ 目录统一管理 Git worktree,保持主代码目录整洁,适合并行开发、PR 审查和隔离工作。命名规则为 {repo-name}--{branch-name},双横线分隔,斜杠转连字符。
主要能力:命令包括 gwt new <branch> 新建、gwt ls 列出(可加 --json)、gwt go <branch> 获取路径、gwt switch <branch>、gwt rm <branch> 删除、gwt here 显示当前 worktree 信息。标志有 --json、--no-env、--keep-branch。会自动从主仓库复制 .env* 和 .dev.vars,可用 GWT_EXTRA_FILES 指定额外文件,GWT_WORKTREE_DIR 覆盖 worktrees 目录。
使用方式:无动作时展示 gwt ls 并解释可用命令。新建后报告路径并提醒切换后运行 bun install。go 输出可复制的 cd 命令,switch 提示命令已复制到剪贴板,rm 前需确认。
注意:为避免 Turbopack/IDE 多锁文件冲突;对远程分支必须先 git fetch origin <branch>,再用 gwt new <branch> origin/<branch>,并验证 git log 的 HEAD。不要用 git reset --hard 或 git checkout 修复错误 worktree,应先 gwt rm 再重建。PR 审查时用 gh pr view 提取分支名。Agent 应始终使用绝对路径,优先用 gwt 而非原生 git worktree。
限制:资料未提供安装方法、收费、平台支持及性能数据。