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

gt-config - Manage settings

gt config [flags]

Manage gt's settings.

Preferences live in config.yml and instance settings in hosts.yml, in the configuration directory ($GITEA_CLI_CONFIG_DIR, or gitea-cli under the XDG config directory); gt config path prints both files. Environment variables that override settings are listed in gt help environment.

Preferences: default_host, git_protocol, editor, prompt (enabled or disabled), pager, browser (never disables opening), color, hyperlinks and markdown (auto or raw), remote, http_timeout, extensions (enabled or disabled), extension_hosts, extension_owners and aliases (see gt alias). Instance settings (--host <url>): user, ssh_host, insecure, git_protocol, oauth_client_id, headers, client_cert and client_key. Account settings (--host <url> --user <name>): ssh_key, ssh_agent, ssh_certificate_principal, ssh_key_fingerprint.

-h, --help[=false] help for config

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

--no-input[=false] Disable prompts and implicit editor/browser interactions

--sudo="" Perform API requests as this user (requires an administrator account)

--user="" Account name on the selected instance

gt(1), gt-config-get(1), gt-config-list(1), gt-config-path(1), gt-config-set(1)

Nov 2026 gitea-cli