gh-pr

Create a pull request

$ gh pr create

$ gh pr list

$ gh pr checkout [pr-number]

$ gh pr view --web

$ gh pr merge [pr-number]

gh pr command [options]

gh pr manages GitHub pull requests from the command line. It provides full pull request lifecycle management including creation, review, merging, and CI status monitoring.
The command integrates with git workflows, automatically detecting the current branch's pull request context. It supports interactive creation with editor integration and automated creation for scripted workflows.
gh pr enables complete pull request workflows without leaving the terminal.

create

Create a new pull request.

List pull requests.

Check out a PR branch locally.

View pull request details.

Merge a pull request.

Close a pull request.

Reopen a pull request.

Mark PR as ready for review.

Show CI status checks.

Add a review to a PR.

Display help information.

Requires repository write access for most operations. PR creation needs branch pushed to remote. Merge may require approvals or passing checks.

gh pr is a core command in the GitHub CLI, providing the pull request workflows that are central to GitHub's collaboration model.

gh(1), gh-pr-merge(1), gh-pr-checks(1)