クイックスタート

gh-vibe は GitHub の Pull Request や Issue を vibe の worktree に変換する gh 拡張です。レビュー用やローカル開発用に worktree をすぐに用意できます。

1. 前提ツールをインストールする

以下のツールが必要です:

• gh — GitHub CLI（gh auth login で認証済みのもの）。
• git — PATH 上にインストール済みであること。
• vibe — gh-vibe が呼び出す worktree マネージャ。

2. gh-vibe をインストールする

gh extension install kexi/gh-vibe

最新の GitHub Release から、自分の環境用のプリビルドバイナリが ダウンロードされて gh のサブコマンドとして登録されます。

3.（任意）シェル自動 cd を有効化する

このステップを省略した場合、gh vibe review は worktree のパスを表示して 終了するだけです。スニペットを仕込むと、シェルが自動でそこに cd します。

# ~/.bashrc or ~/.zshrc
eval "$(gh vibe shell-setup)"

# fish — ~/.config/fish/config.fish
gh vibe shell-setup --shell=fish | source

# PowerShell — $PROFILE
gh vibe shell-setup --shell=pwsh | Out-String | Invoke-Expression

シェルを再読み込みしてから:

gh vibe review 123    # worktree を作成 + 自動 cd

4. 最初の PR をレビューする

origin リモートが PR のベースリポジトリを指している git リポジトリの中で:

gh vibe review 123
# あるいは
gh vibe review https://github.com/owner/repo/pull/123

実際に変更を加えずに動作だけ確認したい場合:

gh vibe review 123 --dry-run

5. issue から作業を開始する

issue を、ラベルとタイトルから導出したブランチ上の worktree に変換します:

gh vibe issue 42

ブランチ名は <type>/<num>-<slug> の形式です。ラベル → type のマッピング 表や --type / --base / --dry-run フラグの詳細は gh vibe issue を参照してください。

詳細はコマンドリファレンスを参照してください。