glab(1)

🌸 NAME 🌸

okay bestie, this is glab(1), and specifically the glab-repo-create page: create a new GitLab project/repository 💖.

✨ SYNOPSIS ✨

glab repo create [path] [flags]

💅 DESCRIPTION 💅

so here's the tea: this command creates the new project using your first configured host in your glab configuration. The host defaults to GitLab.com if it's not set. To set a host, you can provide either:

• a GITLAB_HOST environment variable
• a full URL for the project

If you don't pass --private, --internal, or --public, the project uses the default project visibility of your GitLab instance. no cap.

🎀 OPTIONS 🎀

• --defaultBranch="" — branch name for the new project, overriding both the GitLab instance default and your local git configuration. yes, both 💅
• -d, --description="" — description of the new project. Set it to - to open an editor.
• -g, --group="" — namespace or group for the new project. Defaults to the current user's namespace.
• --internal[=false] — make project internal: visible to any authenticated user.
• -n, --name="" — name of the new project.
• -p, --private[=false] — make project private: visible only to project members.
• -P, --public[=false] — make project public: visible without any authentication.
• --readme[=false] — initialize project with README.md. The repository is cloned locally after creation to ensure the local branch matches the remote, fr fr.
• --remoteName="origin" — remote name for the Git repository you're in. Defaults to origin if not provided.
• -s, --skipGitInit[=false] — skip local repository setup (skips both git init and cloning).
• -t, --tag=[] — the list of topics for the project.

👑 OPTIONS INHERITED FROM PARENT COMMANDS 👑

• -h, --help[=false] — show help for this command 🫶

🌈 EXAMPLE 🌈

bestie, run these exactly as written:

# Create a repository under your account using the current directory name.
glab repo create

# Create a repository under a group using the current directory name.
glab repo create --group glab-cli

# Create a repository with a specific name.
glab repo create my-project

# Create a repository for a group.
glab repo create glab-cli/my-project

# Create on a host other than gitlab.com.
GITLAB_HOST=example.com glab repo create
glab repo create <host>/path/to/repository

🦋 SEE ALSO 🦋

• glab-repo(1) — go check out the parent page too, iykyk 💜

---

💖 okay that's the whole page! Auto generated by spf13/cobra, dated Nov 2026, and part of glab(1) — byeee bestie 🫶