Skip to content
gh-vibe

gh vibe review

Fetches the PR’s head branch (handling fork PRs by namespacing them under pr/<number>/<branch>) and creates a vibe worktree via vibe start --reuse.

Usage

Section titled “Usage”
Terminal window
gh vibe review <PR# | URL>

Both forms are accepted:

Terminal window
gh vibe review 123
gh vibe review https://github.com/owner/repo/pull/123

Flags

Section titled “Flags”

--dry-run

Section titled “--dry-run”

Prints what would happen — the resolved branch, the fetch command, and the vibe start invocation — without making any changes.

Terminal window
gh vibe review 123 --dry-run

Requirements

Section titled “Requirements”
  • gh, git, and vibe available in PATH.
  • Run from inside a git repository whose default remote (origin) points at the PR’s base repo. Fork PRs are fetched into a namespaced ref (pr/<number>/<branch>) so they cannot collide with upstream branches.

What it does

Section titled “What it does”
  1. Resolves the PR via gh pr view (number or URL accepted).
  2. Determines the head branch and whether the PR comes from a fork.
  3. git fetches the head branch (under pr/<number>/<branch> for forks).
  4. Hands off to vibe start --reuse <branch> to create or update the worktree.

Pair this with gh vibe shell-setup so that your shell cds into the worktree on success.