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



NAME
       gt-config - Manage settings



SYNOPSIS
       gt config [flags]



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



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



OPTIONS INHERITED FROM PARENT COMMANDS
       --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



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

gitea-cli                          Nov 2026                       GT-CONFIG(1)