Loading...
Loading...
GitLab merge request operations. ALWAYS use this skill when user wants to: (1) list merge requests, (2) view MR details, (3) create new MRs, (4) approve/merge MRs, (5) checkout MR branches, (6) add notes/comments, (7) rebase MRs.
npx skill4agent add grandcamel/gitlab-assistant-skills gitlab-mrglab| Operation | Command | Risk |
|---|---|---|
| List MRs | | - |
| View MR | | - |
| Create MR | | ⚠️ |
| Checkout MR | | - |
| Approve MR | | ⚠️ |
| Merge MR | | ⚠️⚠️ |
| Update MR | | ⚠️ |
| Close MR | | ⚠️ |
| Reopen MR | | ⚠️ |
| Delete MR | | ⚠️⚠️ |
| Rebase MR | | ⚠️ |
glab mr list [options]| Flag | Description |
|---|---|
| Filter by assignee (use @me for yourself) |
| Filter by reviewer |
| Filter by author |
| Filter by comma-separated labels |
| Filter by state: opened, closed, merged, all |
| Filter by source branch |
| Filter by target branch |
| Number of items per page |
# List MRs assigned to you
glab mr list --assignee=@me
# List review requests for you
glab mr list --reviewer=@me
# List open MRs with specific label
glab mr list --state=opened --label=bug
# List MRs targeting main branch
glab mr list --target-branch=mainglab mr view <id> [options]| Flag | Description |
|---|---|
| Open MR in browser |
| Show MR comments and notes |
| Show system activities/logs |
# View MR details in terminal
glab mr view 123
# Open MR in browser
glab mr view 123 --web
# View MR with comments
glab mr view 123 --commentsglab mr create [options]| Flag | Description |
|---|---|
| MR title |
| MR description |
| Target branch (default: default branch) |
| Use commit messages for title/description |
| Create as draft MR |
| Comma-separated assignees |
| Comma-separated reviewers |
| Comma-separated labels |
| Milestone title |
| Squash commits on merge |
| Remove source branch on merge |
| Open created MR in browser |
| Skip confirmation prompts |
# Create MR with title and description
glab mr create -t "Add new feature" -d "This MR adds..."
# Create MR from commit messages
glab mr create --fill
# Create draft MR
glab mr create --draft -t "WIP: New feature"
# Create MR with reviewers and labels
glab mr create -t "Fix bug" -r "reviewer1,reviewer2" -l "bug,urgent"
# Create MR and open in browser
glab mr create -t "Feature" --webglab mr checkout <id> [options]glab co <id>| Flag | Description |
|---|---|
| Local branch name |
| Set up tracking for the remote branch |
# Checkout MR branch
glab mr checkout 123
# Checkout with custom local branch name
glab mr checkout 123 -b my-local-branch
# Shortcut
glab co 123# Approve MR
glab mr approve <id>
# Revoke approval
glab mr revoke <id>
# View approvers
glab mr approvers <id># Merge MR
glab mr merge <id> [options]
# Close MR
glab mr close <id>
# Reopen closed MR
glab mr reopen <id>| Flag | Description |
|---|---|
| Squash commits |
| Delete source branch after merge |
| Merge when pipeline succeeds |
| Custom merge commit message |
| Skip confirmation |
# Merge with squash
glab mr merge 123 --squash
# Merge and delete source branch
glab mr merge 123 --remove-source-branch
# Auto-merge when pipeline succeeds
glab mr merge 123 --when-pipeline-succeedsglab mr update <id> [options]| Flag | Description |
|---|---|
| Update title |
| Update description |
| Update assignees |
| Update reviewers |
| Update labels |
| Remove labels |
| Mark as draft |
| Mark as ready (remove draft status) |
| Lock discussion |
| Unlock discussion |
# Update title
glab mr update 123 -t "New title"
# Add reviewers
glab mr update 123 -r "user1,user2"
# Mark as ready (remove draft)
glab mr update 123 --ready
# Add and remove labels
glab mr update 123 -l "approved" --unlabel "needs-review"glab mr note <id> -m "<message>"# Add comment
glab mr note 123 -m "LGTM!"
# Add closing note
glab mr note 123 -m "Closing because !456 supersedes this"glab mr rebase <id>glab mr diff <id> [options]| Flag | Description |
|---|---|
| When to show color: always, never, auto |
# Subscribe to MR notifications
glab mr subscribe <id>
# Unsubscribe
glab mr unsubscribe <id>glab mr todo <id># 1. List MRs assigned for review
glab mr list --reviewer=@me
# 2. View MR details
glab mr view 123
# 3. Checkout to test locally
glab mr checkout 123
# 4. Run tests, review code...
# 5. Approve if good
glab mr approve 123
# 6. Add comment
glab mr note 123 -m "Reviewed and approved. Great work!"# 1. Create branch and make changes
git checkout -b feature/my-feature
# 2. Commit changes
git add . && git commit -m "Add new feature"
# 3. Push branch
git push -u origin feature/my-feature
# 4. Create MR
glab mr create -t "Add new feature" -d "Description..." --draft
# 5. Mark ready when done
glab mr update <id> --ready# Create MR from current branch with commit info
glab mr create --fill --yes| Issue | Cause | Solution |
|---|---|---|
| Authentication failed | Invalid/expired token | Run |
| MR not found | Invalid ID or no access | Verify ID with |
| Permission denied | Insufficient rights | Check project permissions |
| Cannot merge | Conflicts or pipeline failed | Resolve conflicts, wait for pipeline |
| Branch not found | Source branch deleted | Check if branch exists |