glab-project

name

glab-project

description

Manage GitLab projects and repositories using the glab CLI. Use this skill whenever the user wants to create a new GitLab project, clone or fork a repository, view project details, manage project members, search for projects, or archive/delete a project. Trigger on phrases like "create a GitLab repo", "fork this project", "clone the project", "add a member to the project", "list my projects", or any GitLab project/repository management task.

GitLab Project Management

Use glab CLI to create, clone, fork, and manage GitLab projects.

Create a Project

glab project create -n <name>
glab project create -n <name> -g <group>        # under a group/namespace
glab project create -n <name> --private          # private visibility
glab project create -n <name> --public           # public visibility
glab project create -n <name> --readme           # initialize with README
glab project create -n <name> -d "<description>"
glab project create -n <name> --defaultBranch main

List Projects

glab project list                  # projects you have access to
glab project list --mine           # your own projects
glab project list -g <group>       # group's projects
glab project list -O json

View a Project

glab project view                         # current directory's project
glab project view <namespace/name>
glab project view -w                      # open in browser

Search Projects

glab project search <query>

Clone a Project

glab project clone <namespace/name>
glab project clone <namespace/name> <local-dir>
glab project clone <url>

Fork a Project

glab project fork                          # fork current project
glab project fork <namespace/name>         # fork a specific project

After forking, clone the fork and add upstream remote:

glab project clone <your-namespace/name>
cd <name>
git remote add upstream [e-mail]:<original-namespace/name>.git

Manage Members

glab project members list
glab project members add <username> --role <role>
# Roles: guest | reporter | developer | maintainer | owner
glab project members delete <username>

Contributors

glab project contributors

Archive / Delete

glab project archive <namespace/name>
glab project delete <namespace/name>      # permanent, requires confirmation

Update Project Settings

glab project update --visibility private
glab project update --description "<new description>"

Behavior Guidelines

1. After creating: Offer to clone the newly created project locally.
2. After forking: Remind the user to configure the upstream remote for keeping the fork in sync.
3. Deletion: Always warn the user that project delete is irreversible and confirm before running.
4. Member roles: Explain role permissions if the user is unsure which role to assign (developer = push/merge, maintainer = settings access, owner = full control).
5. Group projects: Use -g <group> or --group to scope to a specific group.