gitlab

GitLab CLI (glab)

When to Use This Skill

Use glab for GitLab repositories. To detect GitLab:

git remote -v | grep -i gitlab

If the remote contains gitlab.com or a known GitLab instance, use this skill.

Before Any Operation

Always verify authentication first:

glab auth status

If not authenticated, guide the user to run glab auth login.

Behavioral Guidelines

1. Creating MRs: Always check for uncommitted changes first with git status
2. Viewing MRs/Issues: Prefer --comments flag when user wants full context
3. CI Operations: Check glab ci status before suggesting glab ci run
4. Use --web: When the user might benefit from the browser UI

Command Reference

Merge Requests

| Action | Command | |--------|---------| | Create | glab mr create --title "Title" --description "Desc" | | Create draft | glab mr create --draft --title "Title" | | List | glab mr list | | View | glab mr view <id> | | View with comments | glab mr view <id> --comments | | Checkout | glab mr checkout <id> | | Merge | glab mr merge <id> | | Approve | glab mr approve <id> |

Issues

| Action | Command | |--------|---------| | Create | glab issue create --title "Title" --description "Desc" | | List | glab issue list | | List mine | glab issue list --assignee=@me | | View | glab issue view <id> | | Close | glab issue close <id> | | Comment | glab issue note <id> --message "Comment" |

CI/CD Pipelines

| Action | Command | |--------|---------| | Status | glab ci status | | List | glab ci list | | View logs | glab ci trace | | Run new | glab ci run | | Retry failed | glab ci retry |

Repository

| Action | Command | |--------|---------| | View info | glab repo view | | Clone | glab repo clone <repo> | | Open in browser | glab repo view --web|