gw

gw - Git Worktree Wrapper

Git worktree をシンプルに管理するための CLI ツール。

特徴

• 📁 直感的なワークツリー作成（gw add feature/hoge → ../repo-feature-hoge/）
• 🔀 ブランチ名、サフィックス、ディレクトリ名の柔軟な指定
• 🐙 GitHub PR からのワークツリー作成
• 🔍 fzf によるインタラクティブなワークツリー選択
• 🚀 シェル統合によるスムーズなディレクトリ移動

インストール

Homebrew (macOS/Linux)

brew install t98o84/tap/gw

Go

go install github.com/t98o84/gw@latest

バイナリ

Releases からダウンロード。

ソースからビルド

# リポジトリをクローン
git clone https://github.com/t98o84/gw.git
cd gw

# Docker でビルド (macOS Apple Silicon)
docker compose run --rm dev sh -c "CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o gw ."

# Docker でビルド (macOS Intel)
docker compose run --rm dev sh -c "CGO_ENABLED=0 GOOS=darwin GOARCH=amd64 go build -o gw ."

# Docker でビルド (Linux)
docker compose run --rm dev go build -o gw .

# パスの通った場所にコピー
sudo cp gw /usr/local/bin/
# または
mkdir -p ~/.local/bin && cp gw ~/.local/bin/

ローカルに Go がインストールされている場合：

go install github.com/t98o84/gw@latest

シェル統合のセットアップ

gw sw でディレクトリ移動するために、シェル設定に以下を追加してください：

Bash

# ~/.bashrc に追加
eval "$(gw init bash)"

Zsh

# ~/.zshrc に追加
eval "$(gw init zsh)"

Fish

# ~/.config/fish/config.fish に追加
gw init fish | source

使い方

ワークツリーの作成

# 既存ブランチのワークツリーを作成
gw add feature/hoge
# => ../ex-repo-feature-hoge/ が作成される

# 新規ブランチを作成してワークツリーを作成
gw add -b feature/new

# PR のブランチからワークツリーを作成
gw add -pr 123
gw add -pr https://github.com/owner/repo/pull/123

ワークツリー一覧

gw ls
# ex-repo (main)
# ex-repo-feature-hoge
# ex-repo-fix-foo

ワークツリーの削除

# 以下はすべて同じワークツリーを指定
gw rm feature/hoge
gw rm feature-hoge
gw rm ex-repo-feature-hoge

ワークツリーでコマンド実行

gw exec feature/hoge git status
gw exec feature-hoge npm install

ワークツリーへ移動

# 指定したワークツリーに移動
gw sw feature/hoge

# fzf でインタラクティブに選択
gw sw

コマンド一覧

必要なツール

• git
• fzf (オプション: インタラクティブ選択用)
• gh または GITHUB_TOKEN 環境変数 (オプション: PR 連携用)

ライセンス

MIT