SuperAPI AI 工具集

gwt

通用与其它

查看项目

更新于 10-16 06:14

技能介绍

gwt 是一个 git worktree 管理命令行工具,目的是解决嵌套 worktree 造成的问题:Turbopack 检测到多个 lockfile、IDE 文件监听混乱、构建工具遍历嵌套 worktree,以及兄弟目录杂乱。它把所有 worktree 集中放在统一的 worktrees/ 目录中,主代码目录保持干净。目录结构形如 ~/code/my-project(主仓库)、~/code/other-project 与 ~/code/worktrees/,worktree 命名规则为 {repo-name}--{branch-name},分支中的斜杠转为短横。

主要能力包括:创建、列出、定位、切换和删除 worktree,并提供人类用法与 agent 用法两种路径。命令有:gwt new <branch> [from] 创建 worktree(自动复制 .env)、gwt ls 列出当前仓库的 worktree、gwt go <branch> 输出路径、gwt switch <branch> 把 "cd <path> && claude" 复制到剪贴板、gwt rm <branch> 删除 worktree 并删除分支、gwt here 显示当前 worktree 信息、gwt path <branch> 为 go 的别名。标志包括 --json(机器可读输出)、--no-env(跳过复制 .env)、--keep-branch(rm 时不删分支)。环境变量 GWT_WORKTREE_DIR 可覆盖默认的 ../worktrees 目录。

使用方式:新建后可用 cd $(gwt go feat) 进入,或用 gwt switch 将切换命令写入剪贴板再粘贴执行。支持模糊匹配,如 gwt go auth 可匹配 feat-auth。适合在隔离环境中审查 PR、并行开发多个功能、测试改动而不影响主分支、以及运行长时间任务。由于 Claude Code 每次 Bash 调用后工作目录会重置,建议长时间任务开启新会话(gwt switch 复制命令),快速操作则用完整路径,例如 WT=$(gwt go my-feature) 后 cd $WT && bun install。多 worktree 并行时可先批量 gwt new,再获取各路径分别安装依赖或运行命令,也可为每个 worktree 分配子代理;脚本中可用 gwt ls --json 配合 jq 解析。限制与注意事项:worktree 与主仓库共享同一 git 数据库、remotes、refs 和配置,从 worktree 创建的 PR 指向同一仓库;创建后需执行 bun install;未提供的信息(如安装方式、版本、许可、价格、平台要求)暂未提供。