NAME

       gh-pr-create - Create a pull request

SYNOPSIS

       gh pr create [flags]

DESCRIPTION

       Create a pull request on GitHub.

       When  the  current  branch  isn't fully pushed to a git remote, a prompt will ask where to
       push the branch and offer an option to fork the base repository. Use --head to  explicitly
       skip any forking or pushing behavior.

       A  prompt  will  also  ask for the title and the body of the pull request. Use --title and
       --body to skip this, or use --fill to  autofill  these  values  from  git  commits.   It's
       important  to notice that if the --title and/or --body are also provided alongside --fill,
       the values specified by --title and/or --body  will  take  precedence  and  overwrite  any
       autofilled content.

       Link  an  issue  to  the  pull  request  by  referencing the issue in the body of the pull
       request. If the body text mentions Fixes #123 or Closes #123, the  referenced  issue  will
       automatically get closed when the pull request gets merged.

       By  default,  users  with  write access to the base repository can push new commits to the
       head branch of the pull request. Disable this with --no-maintainer-edit.

       Adding a pull request to projects requires  authorization  with  the  project  scope.   To
       authorize, run gh auth refresh -s project.

OPTIONS

       -a, --assignee <login>
              Assign people by their login. Use "@me" to self-assign.

       -B, --base <branch>
              The branch into which you want your code merged

       -b, --body <string>
              Body for the pull request

       -F, --body-file <file>
              Read body text from file (use "-" to read from standard input)

       -d, --draft
              Mark pull request as a draft

       --dry-run
              Print details instead of creating the PR. May still push git changes.

       -f, --fill
              Use commit info for title and body

       --fill-first
              Use first commit info for title and body

       --fill-verbose
              Use commits msg+body for description

       -H, --head <branch>
              The branch that contains commits for your pull request (default [current branch])

       -l, --label <name>
              Add labels by name

       -m, --milestone <name>
              Add the pull request to a milestone by name

       --no-maintainer-edit
              Disable maintainer's ability to modify pull request

       -p, --project <name>
              Add the pull request to projects by name

       --recover <string>
              Recover input from a failed run of create

       -r, --reviewer <handle>
              Request reviews from people or teams by their handle

       -T, --template <file>
              Template file to use as starting body text

       -t, --title <string>
              Title for the pull request

       -w, --web
              Open the web browser to create a pull request

OPTIONS INHERITED FROM PARENT COMMANDS

       -R, --repo <[HOST/]OWNER/REPO>
              Select another repository using the [HOST/]OWNER/REPO format

EXAMPLE

       $ gh pr create --title "The bug is fixed" --body "Everything works again"
       $ gh pr create --reviewer monalisa,hubot  --reviewer myorg/team-name
       $ gh pr create --project "Roadmap"
       $ gh pr create --base develop --head monalisa:feature

SEE ALSO

       gh-pr(1)

                                             Mar 2024                             GH-PR-CREATE(1)