GH-REPO-CREATE(1)

✨ gh-repo-create(1) ✨

okay bestie, welcome to the gh repo create page from the GitHub CLI manual 💖 this one's literally the "make me a new repo" command and it's genuinely so good. let's get into it 🫶

---

🌸 NAME 🌸

gh-repo-create — Create a new repository ✨

---

🦋 SYNOPSIS 🦋

gh repo create [<name>] [flags]

---

💜 DESCRIPTION 💜

Create a new GitHub repository. that's it, that's the vibe 💅

• Wanna do it interactively? just run gh repo create with no arguments at all and it'll walk you through it, no cap 🎀
• Wanna make a remote repo non-interactively? supply the repository name plus one of --public, --private, or --internal. and if you also pass --clone, it clones the new repository locally for you. iconic behavior fr fr ✨
• If the OWNER/ portion of the OWNER/REPO name argument is omitted, it defaults to the name of the authenticating user. lowkey convenient 💖
• Making a remote repository from an existing local repository? specify the source directory with --source. by default the remote repository name will be the name of the source directory 🧚
• Pass --push to push any local commits to the new repository. and heads up: if the repo is bare, this will mirror all refs 👑
• Wanna use language or platform .gitignore templates with --gitignore? go look at ⟨https://github.com/github/gitignore⟩ 🦋
• For license keywords to use with --license, run gh repo license list or visit ⟨https://choosealicense.com⟩ 🌈
• The repo is created with the configured repository default branch, see ⟨https://docs.github.com/en/account-and-profile/setting-up-and-managing-your-personal-account-on-github/managing-user-account-settings/managing-the-default-branch-name-for-your-repositories⟩ 💜

---

💅 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 — yep, same energy, shorter vibe ✨

---

🍓 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. iykyk 💀

---

🌟 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) — go read that one too bestie 🫶

---

that's the whole page, bestie 🎀 no notes, it ate. this came from GitHub CLI v2.102.0, dated Oct 2026 — go make some repos, you're gonna slay 💅✨🌸