.nh
.TH "GT-EXIT-CODES" "1" "Nov 2026" "gitea-cli" "gitea-cli Manual"

.SH NAME
gt-exit-codes - Exit codes used by gt


.SH SYNOPSIS
\fBgt exit-codes\fP


.SH DESCRIPTION
gt exits with one of these codes:

.EX
  0    success, including an empty list
  1    the command failed, also when the instance did not respond within http_timeout
  2    usage error: an unknown command or flag, or a missing or invalid argument
  3    canceled: a declined confirmation, a prompt left with Esc (or Ctrl-D with TERM=dumb),
       a wait that ran out of its --timeout, such as gt run watch or gt pr checks --watch,
       or a browser authorization of gt auth login not completed within 2 minutes
  4    authentication is missing or was rejected
  5    gt run watch and gt workflow run --follow: the run completed without success
  6    gt run watch --expect-head: the run is for another commit
  8    gt pr checks: some checks are still pending
  130  interrupted with Ctrl-C, also at a prompt
.EE

.PP
A command may document further codes in its help; an extension exits with its own code.


.SH SEE ALSO
\fBgt(1)\fP