Skip to content
Documentation

ghpr review status

NAME

Section titled “NAME”

ghpr review status - check the current review status of a pull request

SYNOPSIS

Section titled “SYNOPSIS”
Terminal window
ghpr review status <pr> [options]

DESCRIPTION

Section titled “DESCRIPTION”

Display the current review status of a pull request, including pending reviewers, submitted reviews, and whether there are unresolved comment threads. Supports multiple output formats for both human reading and automation.

ARGUMENTS

Section titled “ARGUMENTS”
ArgumentRequiredDescription
<pr>YesPull request number

OPTIONS

Section titled “OPTIONS”
OptionDescription
-t, --token <token>GitHub personal access token
-r, --repo <owner/repo>Repository in owner/repo format
-f, --format <format>Output format: text (default), json, markdown

EXIT CODES

Section titled “EXIT CODES”
CodeMeaning
0Success
3Error (API error, auth error, PR not found)

OUTPUT

Section titled “OUTPUT”

The command displays:

  • PR title, state, author, and branch info
  • Pending/requested reviewers
  • Submitted reviews with state and timestamp
  • Whether there are unresolved comment threads
  • Summary status: “Ready to merge” / “Changes requested” / “Awaiting review”

EXAMPLES

Section titled “EXAMPLES”

Basic Status Check

Section titled “Basic Status Check”
Terminal window
ghpr review status 123

JSON Output for Scripting

Section titled “JSON Output for Scripting”
Terminal window
ghpr review status 123 --format json

Markdown Output

Section titled “Markdown Output”
Terminal window
ghpr review status 123 -f markdown

Check Status in Another Repository

Section titled “Check Status in Another Repository”
Terminal window
ghpr review status 123 --repo myorg/myrepo

Parse JSON Output with jq

Section titled “Parse JSON Output with jq”
Terminal window
ghpr review status 123 --format json | jq '.reviews[] | select(.state == "APPROVED")'

SEE ALSO

Section titled “SEE ALSO”