Welcome to gh-vibe

Features

PR → worktree

gh vibe review 123 fetches the PR head branch (fork PRs included) and creates a vibe worktree via vibe start --reuse.

Issue → worktree

gh vibe issue 42 derives a <type>/<num>-<slug> branch from the issue’s labels and title and creates a vibe worktree on it.

Worktree status overlay

gh vibe list joins each vibe worktree to its PR’s state, CI rollup, and review decision via a single gh pr list call. --stale filters to merged/closed-PR rows ready for gh vibe clean.

Prune merged worktrees

gh vibe clean finds vibe worktrees whose PR is merged or closed and removes them — with a typed-count confirmation prompt so nothing disappears by accident.

Shell auto-cd

Install the shell snippet — bash, zsh, fish, or PowerShell — and gh vibe review will cd your shell into the freshly-created worktree on success.

Shell tab completion

gh vibe completion --shell=fish (or zsh) wires every subcommand, flag, and enum into your shell, plus dynamic PR / issue numbers (cached 30s per repo) so gh vibe review <TAB> lists what’s open.

Safe by default

The wrapper only evals output fenced with versioned sentinels — unrelated gh stdout can never be executed as shell code.

Cross-platform release

Prebuilt binaries for darwin / linux / windows × arm64 / amd64, installable via gh extension install.

Quick Start

gh extension install kexi/gh-vibe

# Optional: add this line to ~/.zshrc (or ~/.bashrc) so your shell cd's
# into the worktree after `gh vibe review` / `gh vibe issue` succeeds:
eval "$(gh vibe shell-setup)"

gh vibe review 123

Requires gh, git, and vibe in your PATH.