Scroll to navigation

GH-PR-CREATE(1) GitHub CLI manual GH-PR-CREATE(1)

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

Assign people by their login. Use "@me" to self-assign.

The branch into which you want your code merged

Body for the pull request

Read body text from file (use "-" to read from standard input)

Mark pull request as a draft

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

Use commit info for title and body

Use first commit info for title and body

Use commits msg+body for description

The branch that contains commits for your pull request (default [current branch])

Add labels by name

Add the pull request to a milestone by name

Disable maintainer's ability to modify pull request

Add the pull request to projects by name

Recover input from a failed run of create

Request reviews from people or teams by their handle

Template file to use as starting body text

Title for the pull request

Open the web browser to create a pull request

OPTIONS INHERITED FROM PARENT COMMANDS

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