gh-pr-review(1)

gh-pr-review1

Add a review to a pull request

Usage

gh pr review [{<number> | <url> | <branch>}] [flags]

Overview

Add a review to a pull request.

Without an argument, the pull request that belongs to the current branch is reviewed.

Options

-a, --approve

Approve pull request

-b, --body <string>

Specify the body of a review

-F, --body-file <file>

Read body text from file (use "-" to read from standard input)

-c, --comment

Comment on a pull request

-r, --request-changes

Request changes on a pull request

Options inherited from parent commands

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

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

Exit status

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.

Examples

# Approve the pull request of the current branch
$ gh pr review --approve
# Leave a review comment for the current branch
$ gh pr review --comment -b "interesting"
# Add a review for a specific pull request
$ gh pr review 123
# Request changes on a specific pull request
$ gh pr review 123 -r -b "needs more ASCII art"

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

From github-cli 2.102.1-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.