Scroll to navigation

GT-DOCTOR(1) gitea-cli Manual GT-DOCTOR(1)

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)

--template="" Format JSON output using a Go template; implies --json (see gt help formatting)

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

Nov 2026 gitea-cli