wt - Git Worktree Manager

一个基于 gwq 的轻量包装，简化 Git Worktree 的日常使用，特别适合与 AI 编程助手（Claude Code、Codex）配合进行并行开发。

依赖

• gwq - Git worktree manager with fuzzy finder

brew install d-kuro/tap/gwq

安装

1. Clone 本仓库：

git clone https://github.com/nofrish/git-worktree-with-gwq.git ~/.config/wt

2. 在 ~/.zshrc 中添加：

source ~/.config/wt/wt.zsh

3. 重新加载配置：

source ~/.zshrc

命令

命令	说明
wt add	交互式选择分支创建 worktree
wt add <branch>	基于现有分支创建 worktree
wt add -b <name>	创建新分支的 worktree
wt list / wt ls	列出所有 worktree
wt status / wt st	查看所有 worktree 的 git 状态
wt cd [feature]	切换到 worktree 目录（无参数则交互选择）
wt rm <feature>	删除 worktree
wt exec <cmd> [feature]	在 worktree 中执行命令

快捷命令

命令	说明
wt claude [feature]	在 worktree 中启动 Claude Code
wt codex [feature]	在 worktree 中启动 Codex

使用示例

# 交互式选择分支创建 worktree
wt add

# 基于现有分支创建 worktree
wt add main

# 创建新分支的 worktree
wt add -b feature-login

# 查看所有 worktree
wt list

# 交互式选择并切换目录
wt cd

# 直接进入指定 worktree
wt cd feature-login

# 在 worktree 中启动 Claude Code（交互选择）
wt claude

# 在指定 worktree 启动 Claude Code
wt claude feature-login

# 在 worktree 中执行命令
wt exec "npm test" feature-login

# 删除 worktree
wt rm feature-login

为什么使用 Git Worktree + AI 编程助手？

• 并行开发：同时运行多个 Claude Code 实例，各自处理不同功能
• 上下文隔离：每个 worktree 有独立的文件状态，AI 实例互不干扰
• 效率提升：无需频繁切换分支，保持 AI 对代码库的深入理解

Credits

本项目是 gwq 的轻量包装。所有核心功能归功于 gwq 及其作者 @d-kuro。

All credits go to gwq by @d-kuro.

License

MIT