---
name: "gt-doctor"
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-doctor"
---

# gt-doctor(1)

Check gt's setup for this directory

## NAME

gt-doctor - Check gt's setup for this directory

## SYNOPSIS

**gt doctor \[flags\]**

## DESCRIPTION

Check the setup that commands in this directory use: the settings files, the instance, its configured headers and whether it answers, the account and its credential, the repository, and Git. Each problem comes with the command that fixes it. gt doctor fails when a check fails.

### JSON FIELDS

```
checks, host, host_source, repo, repo_source, user, user_source
```

## OPTIONS

**-h**, **--help**\[=false\]\
 	help for doctor

## OPTIONS INHERITED FROM PARENT COMMANDS

**--csv**\[=""\]\
 	Output CSV with the specified comma-separated **fields**, or all fields

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

**-q**, **--jq**=""\
 	Filter JSON output using a jq **expression**; implies --json

**--json**\[=""\]\
 	Output JSON with the specified comma-separated **fields**, or all fields

**--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 doctor
# Check another repository and instance
$ gt doctor -R gitea.com/gitea/cli
$ gt doctor --jq '.checks[] | select(.status == "failed")'
```

## SEE ALSO

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