Merge Request Skill

Merge request operations for GitLab using the glab CLI.

Quick Reference

Risk Legend: - Safe | ⚠️ Caution | ⚠️⚠️ Warning | ⚠️⚠️⚠️ Danger

When to Use This Skill

ALWAYS use when:

• User wants to work with merge requests
• User mentions "MR", "merge request", "pull request", or related terms
• User wants to review, approve, or merge code

NEVER use when:

• User wants bulk operations on 10+ MRs (use gitlab-bulk instead)
• User is only searching/filtering MRs (use gitlab-search instead)

Available Commands

List Merge Requests

glab mr list [options]

Options:

Examples:

# 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=main

View Merge Request Details

glab mr view <id> [options]

Options:

Examples:

# 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 --comments

Create Merge Request

glab mr create [options]

Options:

Examples:

# 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" --web

Checkout Merge Request Branch

glab mr checkout <id> [options]

Shortcut: glab co <id>

Options:

Examples:

# 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/Revoke Merge Request

# Approve MR
glab mr approve <id>

# Revoke approval
glab mr revoke <id>

# View approvers
glab mr approvers <id>

Merge/Close/Reopen

# Merge MR
glab mr merge <id> [options]

# Close MR
glab mr close <id>

# Reopen closed MR
glab mr reopen <id>

Merge Options:

Examples:

# 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-succeeds

Update Merge Request

glab mr update <id> [options]

Options:

Examples:

# 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"

Add Note/Comment

glab mr note <id> -m "<message>"

Examples:

# Add comment
glab mr note 123 -m "LGTM!"

# Add closing note
glab mr note 123 -m "Closing because !456 supersedes this"

Rebase Merge Request

glab mr rebase <id>

View Diff

glab mr diff <id> [options]

Options:

Subscribe/Unsubscribe

# Subscribe to MR notifications
glab mr subscribe <id>

# Unsubscribe
glab mr unsubscribe <id>

Add to Todo

glab mr todo <id>

Common Workflows

Workflow 1: Review and Approve

# 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!"

Workflow 2: Create Feature MR

# 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

Workflow 3: Quick Fix

# Create MR from current branch with commit info
glab mr create --fill --yes

Troubleshooting

Related Documentation

• Safeguards
• Quick Reference