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



NAME
       gt-pr - Manage pull requests



SYNOPSIS
       gt pr [flags]



DESCRIPTION
       Work with Gitea pull requests: list, view, create, review, check out
       and merge them.


       Commands that act on one pull request take a number, a URL or a branch
       name, and without one select the pull request of the current branch. pr
       attachment takes a number or a URL.


   ARGUMENTS
       A pull request can be supplied as argument in any of the following formats:
       - by number, such as "13" or "#13"
       - by URL, such as "https://gitea.com/OWNER/REPO/pulls/13"
       - by the name of its head branch, such as "feature/login" or "bob:feature/login"; a branch that
         reads as OWNER/REPO#N, such as "fix/login#2", needs the OWNER:BRANCH form

       Without an argument, the pull request of the current branch is selected.



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



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



EXAMPLE
       $ gt pr list --author @me
       $ gt pr create --fill
       $ gt pr merge --squash --delete-branch



SEE ALSO
       gt(1), gt-pr-attachment(1), gt-pr-backport(1), gt-pr-checkout(1), gt-
       pr-checks(1), gt-pr-clean(1), gt-pr-close(1), gt-pr-comment(1), gt-pr-
       create(1), gt-pr-diff(1), gt-pr-edit(1), gt-pr-list(1), gt-pr-merge(1),
       gt-pr-ready(1), gt-pr-reopen(1), gt-pr-review(1), gt-pr-status(1), gt-
       pr-timeline(1), gt-pr-update-branch(1), gt-pr-view(1)

gitea-cli                          Nov 2026                           GT-PR(1)