gh-pr

Create a pull request

$ gh pr [[new|create]]

$ gh [[co|pr checkout]] [pr_number|url|branch]

$ gh pr diff

$ gh pr review [[-a|--approve]]

$ gh pr merge

$ gh pr edit

$ gh pr edit [[-B|--base]] [branch_name]

$ gh pr status

gh pr <command> [<args>...] [flags]

-R, --repo <HOST/>OWNER/REPO
    Select another repository using the [HOST/]OWNER/REPO format

-h, --help
    Show help for command

gh pr is a subcommand of the GitHub CLI (gh), enabling seamless management of pull requests (PRs) from the Linux terminal. It supports workflows like creating PRs from local branches, viewing details, listing open PRs, merging with strategies like rebase or squash, applying reviews, and checking out remote PRs into git branches.

Designed for developers, it minimizes browser use by integrating with git. For example, gh pr create drafts a PR with title, body, base branch, and reviewers. Flags allow targeting specific repos via --repo.

Requires GitHub authentication (gh auth login) and git repository context. Handles draft PRs, labels, assignees, and milestones. Output formats include table, JSON via --jq on subcommands. Ideal for CI/CD, team collaboration, and power users. Supports GitHub Enterprise with --hostname (global flag). Regularly updated with GitHub features.

Requires gh installed (<code>apt install gh</code> or similar), GitHub auth, and internet. Subcommand-specific flags/flags override globals; no offline mode.

create: Create PR
view: View PR details
list: List PRs
merge: Merge PR
checkout: Checkout PR branch

gh pr create --title 'Fix bug' --body 'Details'
gh pr view 123 --web (opens in browser)

Part of GitHub CLI, first released Feb 2020 (v0.5.0) as open-source Rust tool by GitHub. gh pr evolved from early betas, adding subcommands like rebase-merge (v1.0+), review APIs (v2.0+). Now at v2.40+, mirrors web UI features.

gh(1), git(1), hub(1)