d-kuro/gwq

解决的问题

gwq 是一个旨在简化 Git worktrees 管理的 CLI 工具，让开发者能为单一仓库维护多个隔离的工作目录。这消除了频繁切换分支和暂存变更的需求，对于并行开发、代码审查以及同时在不同任务上运行多个 AI 编码代理特别有用。

运作方式

该工具提供了一个高阶接口来创建、切换和删除 worktrees。它使用基于 URL 的目录层级结构（例如 ~/worktrees/github.com/user/repo/branch）来组织这些目录并避免命名冲突。它内置了模糊搜索器（fuzzy finder）以便快速选择分支和 worktrees，并与 Shell 环境集成，实现无缝的目录切换 (cd) 与 Tab 键自动补全。

目标用户

主要针对同时处理多个功能或错误修复的开发者，以及使用 AI 编码代理且需要隔离环境以在不产生合并冲突的情况下全速运作的用户。

特色亮点

• 模糊搜索接口 (Fuzzy Finder Interface)：通过内置的模糊搜索器进行直观的分支与 worktree 选择。
• 全局管理：能够从单一位置访问并监控跨不同仓库的所有 worktrees。
• 状态仪表板：实时监控所有 worktrees 的 git 状态、变更与活动。
• Tmux 集成：支持在持久的 tmux 会话中管理长时间运行的程序。
• 自动化设置：针对每个仓库的配置，可在创建 worktree 时自动复制文件（如 .env 文件）并执行设置指令（如 npm install）。
• Shell 集成：与 Bash、Zsh、Fish 和 PowerShell 深度集成，提供 Tab 键自动补全与当前 Shell 目录切换功能。