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

FreeBSD Manual Pages

  
 
  

home | help 
GH-REPO-CREATE(1)	       GitHub CLI manual	     GH-REPO-CREATE(1)

NAME
       gh-repo-create -	Create a new repository

SYNOPSIS
       gh repo create [<name>] [flags]

DESCRIPTION
       Create a	new GitHub repository.

       To  create a repository interactively, use gh repo create with no argu-
       ments.

       To create a remote repository non-interactively,	supply the  repository
       name  and  one  of --public, --private, or --internal.  Pass --clone to
       clone the new repository	locally.

       If the OWNER/ portion of	the OWNER/REPO name argument  is  omitted,  it
       defaults	to the name of the authenticating user.

       To  create a remote repository from an existing local repository, spec-
       ify the source directory	with --source.	By default, the	remote reposi-
       tory name will be the name of the source	directory.

       Pass --push to push any local commits to	the  new  repository.  If  the
       repo is bare, this will mirror all refs.

       For  language or	platform .gitignore templates to use with --gitignore,
       <https://github.com/github/gitignore>.

       For license keywords to use with	--license, run gh repo license list or
       visit <https://choosealicense.com>.

OPTIONS
       --add-readme
	      Add a README file	to the new repository

       -c, --clone
	      Clone the	new repository to the current directory

       -d, --description <string>
	      Description of the repository

       --disable-issues
	      Disable issues in	the new	repository

       --disable-wiki
	      Disable wiki in the new repository

       -g, --gitignore <string>
	      Specify a	gitignore template for the repository

       -h, --homepage <URL>
	      Repository home page URL

       --include-all-branches
	      Include all branches from	template repository

       --internal
	      Make the new repository internal

       -l, --license <string>
	      Specify an Open Source License for the repository

       --private
	      Make the new repository private

       --public
	      Make the new repository public

       --push Push local commits to the	new repository

       -r, --remote <string>
	      Specify remote name for the new repository

       -s, --source <string>
	      Specify path to local repository to use as source

       -t, --team <name>
	      The name of the organization team	to be granted access

       -p, --template <repository>
	      Make the new repository based on a template repository

ALIASES
       gh repo 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
       # create	a repository interactively
       gh repo create

       # create	a new remote repository	and clone it locally
       gh repo create my-project --public --clone

       # create	a new remote repository	in a different organization
       gh repo create my-org/my-project	--public

       # create	a remote repository from the current directory
       gh repo create my-project --private --source=. --remote=upstream

SEE ALSO
       gh-repo(1)

				   Apr 2025		     GH-REPO-CREATE(1)

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

home | help