glab-repo-create(1)

glab-repo-create1

Create a new gitlab project/repository.

Usage

glab repo create [path] [flags]

Overview

Creates the new project with your first configured host in your glab configuration. The host defaults to GitLab.com if not set. To set a host, 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.

Options

--defaultBranch=""
Branch name for the new project, overriding both the GitLab instance default and your local git configuration.

-d, --description=""
Description of the new project. Set 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.

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

Examples

# 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

Releases

2 releases since Debian 13 (Trixie); the text changed 1 time.

  1. 13
  2. Arch

From glab 1.126.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.