d-kuro/gwq

解決する課題

gwq は、Git worktreeの管理を簡素化するために設計されたCLIツールです。開発者は単一のリポジトリに対して複数の隔離された作業ディレクトリを維持できます。これにより、頻繁なブランチの切り替えや変更のスタッシュが不要になり、並行開発、コードレビュー、複数のAIコーディングエージェントを異なるタスクで同時に実行する場合に特に役立ちます。

仕組み

このツールは、worktreeの作成、切り替え、削除を行うための高レベルなインターフェースを提供します。URLベースのディレクトリ階層（例: ~/worktrees/github.com/user/repo/branch）を使用してディレクトリを整理し、名前の競合を回避します。内蔵のファジーファインダー（fuzzy finder）により、ブランチやworktreeを素早く選択でき、シェル環境と統合することでシームレスなディレクトリ変更 (cd) やタブ補完が可能です。

対象ユーザー

複数の機能開発やバグ修正を同時に行う開発者、およびマージ競合なしでフルスピードで動作するために隔離された環境を必要とするAIコーディングエージェントを使用する開発者に最適です。

主な特徴

• ファジーファインダーインターフェース: 内蔵のファジーファインダーによる直感的なブランチとworktreeの選択。
• グローバル管理: 異なるリポジトリにまたがるすべてのworktreeを単一の場所からアクセスおよび監視可能。
• ステータスダッシュボード: すべてのworktreeのgitステータス、変更、アクティビティをリアルタイムで監視。
• Tmux統合: 長時間実行されるプロセスを永続的なtmuxセッションで管理するためのサポート。
• 自動セットアップ: リポジトリごとの設定により、worktree作成時にファイルを自動コピー（.envファイルなど）し、セットアップコマンド（npm installなど）を実行可能。
• シェル統合: Bash、Zsh、Fish、PowerShellとの深い統合により、タブ補完と現在のシェルでのディレクトリ変更をサポート。