.nh
.TH "GT-COMMIT-COMPARE" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"
.SH NAME
gt-commit-compare - List the commits that one ref has and another has not
.SH SYNOPSIS
\fBgt commit compare {...
| } [flags]\fP
.SH DESCRIPTION
List the commits that has and has not: what a pull request from into
would bring. Both are branches, tags or commits.
.SS ARGUMENTS
.EX
A repository can be supplied as NAME (one of yours), OWNER/NAME, HOST/OWNER/NAME or a URL.
Without an argument, the repository of the current Git clone is used.
.EE
.SS JSON FIELDS
.EX
base, commits, head, total_commits
.EE
.SH OPTIONS
\fB-h\fP, \fB--help\fP[=false]
help for compare
.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--csv\fP[=""]
Output CSV with the specified comma-separated \fBfields\fR, or all fields
.PP
\fB--cwd\fP=""
Working \fBdirectory\fR for repository discovery
.PP
\fB--debug\fP[=false]
Log the method, URL, status, and duration of each HTTP request to stderr
.PP
\fB--host\fP=""
Gitea instance \fBURL\fR, including any base path
.PP
\fB--interactive\fP[=false]
Allow prompts with machine output
.PP
\fB-q\fP, \fB--jq\fP=""
Filter JSON output using a jq \fBexpression\fR; implies --json
.PP
\fB--json\fP[=""]
Output JSON with the specified comma-separated \fBfields\fR, or all fields
.PP
\fB--no-input\fP[=false]
Disable prompts and implicit editor/browser interactions
.PP
\fB--remote\fP=""
Git \fBremote\fR used for repository discovery
.PP
\fB-R\fP, \fB--repo\fP=""
Select a repository as \fBOWNER/REPO\fR or URL
.PP
\fB--sudo\fP=""
Perform API requests as this \fBuser\fR (requires an administrator account)
.PP
\fB--template\fP=""
Format JSON output using a Go \fBtemplate\fR; implies --json (see gt help formatting)
.PP
\fB--user\fP=""
Account \fBname\fR on the selected instance
.SH EXAMPLE
.EX
$ gt commit compare main...feature/login
$ gt commit compare v1.1.0 v1.2.0 --json total_commits
.EE
.SH SEE ALSO
\fBgt-commit(1)\fP