Scroll to navigation

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

NAME

gh-pr-diff - View changes in a pull request

SYNOPSIS

gh pr diff [<number> | <url> | <branch>] [flags]

DESCRIPTION

View changes in a pull request.

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

With --web flag, open the pull request diff in a web browser instead.

Use --exclude to filter out files matching a glob pattern. The pattern uses forward slashes as path separators on all platforms. You can repeat the flag to exclude multiple patterns.

OPTIONS

Use color in diff output: {always|never|auto}

Exclude files matching glob patterns from the diff

Display only names of changed files

Display diff in patch format

Open the pull request diff in the browser

OPTIONS INHERITED FROM PARENT COMMANDS

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

# See diff for current branch
$ gh pr diff
# See diff for a specific PR
$ gh pr diff 123
# Exclude files from diff output
$ gh pr diff --exclude '*.yml' --exclude 'generated/*'
# Exclude matching files by name
$ gh pr diff --name-only --exclude '*.generated.*'

SEE ALSO

gh-pr(1)

Mar 2026 GitHub CLI v2.89.0