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

gt-auth - Authenticate gt and git with Gitea

gt auth [flags]

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.

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

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

Nov 2026 gitea-cli