1GH-REPO-CREATE(1)              GitHub CLI manual             GH-REPO-CREATE(1)
2
3
4

NAME

6       gh-repo-create - Create a new repository
7
8
9

SYNOPSIS

11       gh repo create [<name>] [flags]
12
13
14

DESCRIPTION

16       Create a new GitHub repository.
17
18
19       To  create a repository interactively, use gh repo create with no argu‐
20       ments.
21
22
23       To create a remote repository non-interactively, supply the  repository
24       name  and  one  of --public, --private, or --internal.  Pass --clone to
25       clone the new repository locally.
26
27
28       To create a remote repository from an existing local repository,  spec‐
29       ify the source directory with --source.  By default, the remote reposi‐
30       tory name will be the name of the source  directory.   Pass  --push  to
31       push any local commits to the new repository.
32
33
34

OPTIONS

36       --add-readme
37              Add a README file to the new repository
38
39
40       -c, --clone
41              Clone the new repository to the current directory
42
43
44       -d, --description <string>
45              Description of the repository
46
47
48       --disable-issues
49              Disable issues in the new repository
50
51
52       --disable-wiki
53              Disable wiki in the new repository
54
55
56       -g, --gitignore <string>
57              Specify a gitignore template for the repository
58
59
60       -h, --homepage <URL>
61              Repository home page URL
62
63
64       --include-all-branches
65              Include all branches from template repository
66
67
68       --internal
69              Make the new repository internal
70
71
72       -l, --license <string>
73              Specify an Open Source License for the repository
74
75
76       --private
77              Make the new repository private
78
79
80       --public
81              Make the new repository public
82
83
84       --push Push local commits to the new repository
85
86
87       -r, --remote <string>
88              Specify remote name for the new repository
89
90
91       -s, --source <string>
92              Specify path to local repository to use as source
93
94
95       -t, --team <name>
96              The name of the organization team to be granted access
97
98
99       -p, --template <repository>
100              Make the new repository based on a template repository
101
102
103

EXAMPLE

105       # create a repository interactively
106       gh repo create
107
108       # create a new remote repository and clone it locally
109       gh repo create my-project --public --clone
110
111       # create a remote repository from the current directory
112       gh repo create my-project --private --source=. --remote=upstream
113
114
115
116
117

SEE ALSO

119       gh-repo(1)
120
121
122
123                                   Nov 2023                  GH-REPO-CREATE(1)
Impressum