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



NAME
       gt-branch - Manage remote branches and protection rules



SYNOPSIS
       gt branch [flags]



DESCRIPTION
       Work with the branches of a repository on the server: list and view
       them, create, rename and delete them, and protect them from direct
       pushes. gt branch protection list and view show the protection rules.
       To work with local branches, use git.



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



OPTIONS INHERITED FROM PARENT COMMANDS
       --cwd=""  Working directory for repository discovery


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


       --remote=""    Git remote used for repository discovery


       -R, --repo=""  Select a repository as OWNER/REPO or URL


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


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



SEE ALSO
       gt(1), gt-branch-create(1), gt-branch-delete(1), gt-branch-list(1), gt-
       branch-protect(1), gt-branch-protection(1), gt-branch-rename(1), gt-
       branch-unprotect(1), gt-branch-view(1)

gitea-cli                          Nov 2026                       GT-BRANCH(1)