Scroll to navigation

GT-PR-DIFF(1) gitea-cli Manual GT-PR-DIFF(1)

NAME

gt-pr-diff - Show the changes of a pull request

SYNOPSIS

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

DESCRIPTION

Show the changes of a pull request as a unified diff.

On a terminal the diff is colored and paged. Piped, it is written unchanged, so that gt pr diff 13 | git apply works, and --name-only writes the exact file names.

--path and --exclude narrow the diff to files, as the file tree of the web interface does, and --name-status and --stat summarize it. Gitea's API has no options for what a diff contains, such as ignoring whitespace, so these work on the diff after gt has read it.

ARGUMENTS

A pull request can be supplied as argument in any of the following formats:
- by number, such as "13" or "#13"
- by URL, such as "https://gitea.com/OWNER/REPO/pulls/13"
- by the name of its head branch, such as "feature/login" or "bob:feature/login"; a branch that

reads as OWNER/REPO#N, such as "fix/login#2", needs the OWNER:BRANCH form Without an argument, the pull request of the current branch is selected.

OPTIONS

--color="auto" Color the diff {auto|always|never}

-e, --exclude=[] Leave out files matching pattern, which is written like --path (repeatable)

-h, --help[=false] help for diff

--name-only[=false] List only the names of the changed files

--name-status[=false] List the changed files with A, M, D or R for how they changed

--path=[] Show only files matching pattern: a file, a directory/, or a glob such as '*.go' or 'internal/*/_test.go' (repeatable)

--stat[=false] Show how many lines each file changed, and the total, instead of the diff

-w, --web[=false] Open the changed files in the browser

OPTIONS INHERITED FROM PARENT COMMANDS

--cwd="" Working directory for repository discovery

--debug[=false] Log the method, URL, status, and duration of each HTTP request to stderr

--host="" Gitea instance URL, including any base path

--interactive[=false] Allow prompts with machine output

--no-input[=false] Disable prompts and implicit editor/browser interactions

--remote="" Git remote used for repository discovery

-R, --repo="" Select a repository as OWNER/REPO or URL

--sudo="" Perform API requests as this user (requires an administrator account)

--user="" Account name on the selected instance

EXAMPLE

$ gt pr diff
$ gt pr diff 13 --name-only
$ gt pr diff 13 --path 'internal/' --exclude '*_test.go'
$ gt pr diff 13 --stat
$ gt pr diff 13 | git apply

SEE ALSO

gt-pr(1)

Nov 2026 gitea-cli