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



NAME
       gt-auth-switch - Switch the active account of an instance



SYNOPSIS
       gt auth switch [<user>] [flags]



DESCRIPTION
       Switch the active account of an instance, which commands use unless
       --user or GITEA_CLI_USER selects another. With two accounts, gt auth
       switch toggles between them; with more, it asks which one on a
       terminal.



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



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



EXAMPLE
       $ gt auth switch
       $ gt auth switch bob
       $ gt auth switch bob --host gitea.com



SEE ALSO
       gt-auth(1)

gitea-cli                          Nov 2026                  GT-AUTH-SWITCH(1)