GH-PR(1) GitHub CLI manual GH-PR(1)

# [NAME](#NAME)

gh-pr - Manage pull requests

# [SYNOPSIS](#SYNOPSIS)

**gh pr <command> \[flags]**

# [DESCRIPTION](#DESCRIPTION)

Work with GitHub pull requests.

# [GENERAL COMMANDS](#GENERAL_COMMANDS)

[**gh-pr-create(1)**](#gh_pr_create%281%29)

Create a pull request

[**gh-pr-list(1)**](#gh_pr_list%281%29)

List pull requests in a repository

[**gh-pr-status(1)**](#gh_pr_status%281%29)

Show status of relevant pull requests

# [TARGETED COMMANDS](#TARGETED_COMMANDS)

[**gh-pr-checkout(1)**](#gh_pr_checkout%281%29)

Check out a pull request in git

[**gh-pr-checks(1)**](#gh_pr_checks%281%29)

Show CI status for a single pull request

[**gh-pr-close(1)**](#gh_pr_close%281%29)

Close a pull request

[**gh-pr-comment(1)**](#gh_pr_comment%281%29)

Add a comment to a pull request

[**gh-pr-diff(1)**](#gh_pr_diff%281%29)

View changes in a pull request

[**gh-pr-edit(1)**](#gh_pr_edit%281%29)

Edit a pull request

[**gh-pr-lock(1)**](#gh_pr_lock%281%29)

Lock pull request conversation

[**gh-pr-merge(1)**](#gh_pr_merge%281%29)

Merge a pull request

[**gh-pr-ready(1)**](#gh_pr_ready%281%29)

Mark a pull request as ready for review

[**gh-pr-reopen(1)**](#gh_pr_reopen%281%29)

Reopen a pull request

[**gh-pr-revert(1)**](#gh_pr_revert%281%29)

Revert a pull request

[**gh-pr-review(1)**](#gh_pr_review%281%29)

Add a review to a pull request

[**gh-pr-unlock(1)**](#gh_pr_unlock%281%29)

Unlock pull request conversation

[**gh-pr-update-branch(1)**](#gh_pr_update_branch%281%29)

Update a pull request branch

[**gh-pr-view(1)**](#gh_pr_view%281%29)

View a pull request

# [OPTIONS](#OPTIONS)

[**-R**, **--repo** **<\[HOST/\]OWNER/REPO>**](#R)

Select another repository using the \[HOST/]OWNER/REPO format

# [EXIT CODES](#EXIT_CODES)

0: Successful execution

1: Error

2: Command canceled

4: Authentication required

NOTE: Specific commands may have additional exit codes. Refer to the command's help for more information.

# [EXAMPLE](#EXAMPLE)

```
$ gh pr checkout 353
$ gh pr create --fill
$ gh pr view --web
```

# [SEE ALSO](#SEE_ALSO)

[**gh(1)**](/man/os/gh/gh.1)

Oct 2026

---

Document: gh-pr(1) from gh 2.102.0-r1 (Chainguard OS)
Source: https://github.com/cli/cli