GHPR CLI Reference

GHPR is a command-line tool for managing GitHub Pull Request reviews and comments. It provides automation for requesting reviews, tracking review status, and managing comment threads.

Command Groups

Review Commands

Command	Description
ghpr review request	Request a review from a user, team, or Copilot
ghpr review status	Check the current review status of a PR
ghpr review wait	Poll until a review is complete

Comment Commands

Command	Description
ghpr comment list	List comment threads on a PR
ghpr comment reply	Reply to a specific comment thread
ghpr comment resolve	Resolve a comment thread

Utility Commands

Command	Description
ghpr update	Update ghpr to the latest version

Authentication

Token resolution order (first match wins):

1. --token CLI option
2. GPR_PAT environment variable
3. .ghpr file in current directory
4. gh auth token command output (GitHub CLI)

Required Permissions:

• repo scope for private repositories
• public_repo scope for public repositories only

Repository Discovery

Repository is determined by (in order):

1. --repo CLI option (owner/repo format)
2. Git remote URL (prefers upstream over origin)
3. Current directory git config

Global Options

All commands support these options:

Option	Description
-t, --token <token>	GitHub personal access token
-r, --repo <owner/repo>	Repository in owner/repo format

Common Exit Codes

Code	Meaning
0	Success
1	Changes requested (for review wait)
2	Timeout (for review wait)
3	Error (API error, auth error, validation)

ID Types

GHPR uses two different ID types for comments:

Format	Type	Usage
PRRT_*	Thread ID	Used with comment resolve
Numeric	Comment ID	Used with comment reply

Both IDs are displayed when listing comments.

Installation

Prerequisites:

• .NET 8.0 SDK or later
• GitHub CLI (gh) authenticated

Install Latest:

gh release download --repo LeverageSoftwareGroup/ghpr --pattern 'install.sh' --output - | bash

Install Specific Version:

gh release download v1.2.3 --repo LeverageSoftwareGroup/ghpr --pattern 'install.sh' --output - | bash -s -- 1.2.3

Uninstall:

dotnet tool uninstall -g ghpr