Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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	behav-
       ior.

       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 aut-
       ofilled content.

       The base	branch for the created PR can be specified  using  the	--base
       flag.  If  not  provided,  the value of gh-merge-base git branch	config
       will be used. If	not configured,	the repository's default  branch  will
       be used.

       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.

       -e, --editor
	      Skip prompts and open the	text editor to	write  the  title  and
	      body  in.	 The first line	is the title and the remaining text is
	      the body.

       -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 <title>
	      Add the pull request to projects by title

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

ALIASES
       gh pr new

EXIT CODES
       0: Successful execution

       1: Error

       2: Command canceled

       4: Authentication required

       NOTE:  Specific	commands  may have additional exit codes. Refer	to the
       command's help for more information.

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
       $ gh pr create --template "pull_request_template.md"

SEE ALSO
       gh-pr(1)

				   Apr 2025		       GH-PR-CREATE(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=gh-pr-create&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help