d-kuro/gwq

🌳 Git worktree manager with fuzzy finder - Work on multiple branches simultaneously, perfect for parallel AI coding workflows 🍋

What it solves

gwq is a CLI tool designed to simplify the management of Git worktrees, allowing developers to maintain multiple isolated working directories for a single repository. This eliminates the need to constantly switch branches and stash changes, which is especially useful for parallel development, code reviews, and running multiple AI coding agents on different tasks simultaneously.

How it works

The tool provides a high-level interface for creating, switching to, and deleting worktrees. It uses a URL-based directory hierarchy (e.g., ~/worktrees/github.com/user/repo/branch) to organize these directories and avoid naming conflicts. It includes a built-in fuzzy finder for quickly selecting branches and worktrees, and integrates with shell environments to allow seamless directory changes (cd) and tab completion.

Who it’s for

It is primarily for developers who work on multiple features or bug fixes concurrently and those who use AI coding agents that require isolated environments to work at full speed without merge conflicts.

Highlights

  • Fuzzy Finder Interface: Intuitive branch and worktree selection via a built-in fuzzy finder.
  • Global Management: Ability to access and monitor all worktrees across different repositories from a single location.
  • Status Dashboard: A real-time monitor for git status, changes, and activity across all worktrees.
  • Tmux Integration: Support for managing long-running processes in persistent tmux sessions.
  • Automated Setup: Per-repository configuration for automatically copying files (like .env files) and running setup commands (like npm install) upon worktree creation.
  • Shell Integration: Deep integration with Bash, Zsh, Fish, and PowerShell for tab completion and current-shell directory changes.

Related

  • Project
  • Project
  • Project
  • Project