---
name: "gt-exit-codes"
section: "1"
platform: "linux"
package: "gitea-cli"
version: "1.0.0-1"
release: "Arch Linux 2026-11-07"
platforms: ["linux"]
url: "https://carta.tech/man/gt-exit-codes"
---

# gt-exit-codes(1)

Exit codes used by gt

## NAME

gt-exit-codes - Exit codes used by gt

## SYNOPSIS

**gt exit-codes**

## DESCRIPTION

gt exits with one of these codes:

```
  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
```

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

## SEE ALSO

**[gt(1)](/man/gt/1.md)**