---
name: "gh-pr"
section: "1"
platform: "linux"
package: "github-cli"
version: "2.102.1-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/gh-pr"
---

# gh-pr(1)

Manage pull requests

## NAME

gh-pr - Manage pull requests

## SYNOPSIS

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

## DESCRIPTION

Work with GitHub pull requests.

## GENERAL COMMANDS

- **[gh-pr-create(1)](/gh-pr-create/1.md)**

  Create a pull request

- **[gh-pr-list(1)](/gh-pr-list/1.md)**

  List pull requests in a repository

- **[gh-pr-status(1)](/gh-pr-status/1.md)**

  Show status of relevant pull requests

## TARGETED COMMANDS

- **[gh-pr-checkout(1)](/gh-pr-checkout/1.md)**

  Check out a pull request in git

- **[gh-pr-checks(1)](/gh-pr-checks/1.md)**

  Show CI status for a single pull request

- **[gh-pr-close(1)](/gh-pr-close/1.md)**

  Close a pull request

- **[gh-pr-comment(1)](/gh-pr-comment/1.md)**

  Add a comment to a pull request

- **[gh-pr-diff(1)](/gh-pr-diff/1.md)**

  View changes in a pull request

- **[gh-pr-edit(1)](/gh-pr-edit/1.md)**

  Edit a pull request

- **[gh-pr-lock(1)](/gh-pr-lock/1.md)**

  Lock pull request conversation

- **[gh-pr-merge(1)](/gh-pr-merge/1.md)**

  Merge a pull request

- **[gh-pr-ready(1)](/gh-pr-ready/1.md)**

  Mark a pull request as ready for review

- **[gh-pr-reopen(1)](/gh-pr-reopen/1.md)**

  Reopen a pull request

- **[gh-pr-revert(1)](/gh-pr-revert/1.md)**

  Revert a pull request

- **[gh-pr-review(1)](/gh-pr-review/1.md)**

  Add a review to a pull request

- **[gh-pr-unlock(1)](/gh-pr-unlock/1.md)**

  Unlock pull request conversation

- **[gh-pr-update-branch(1)](/gh-pr-update-branch/1.md)**

  Update a pull request branch

- **[gh-pr-view(1)](/gh-pr-view/1.md)**

  View a pull request

## OPTIONS

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

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

## 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

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

## SEE ALSO

**[gh(1)](/gh/1.md)**