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



NAME
       gt-auth - Authenticate gt and git with Gitea



SYNOPSIS
       gt auth [flags]



DESCRIPTION
       Authenticate gt and git with Gitea.


       gt keeps the accounts of each instance in hosts.yml and their tokens in
       the system keyring, or in a private file when you choose so. One
       account per instance is active; --user or GITEA_CLI_USER selects
       another for a single command. GITEA_TOKEN, together with GITEA_CLI_HOST
       or GITEA_INSTANCE_URL, replaces the stored credentials of its instance
       for the active account too; it must belong to the account that --user
       or GITEA_CLI_USER names. See gt help environment for how commands
       select the instance.



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



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-auth-login(1), gt-auth-logout(1), gt-auth-refresh(1), gt-
       auth-setup-git(1), gt-auth-status(1), gt-auth-switch(1), gt-auth-
       token(1)

gitea-cli                          Nov 2026                         GT-AUTH(1)