gitlab-issue

Issue Skill

Issue operations for GitLab using the glab CLI.

Quick Reference

Operation	Command	Risk
List issues	glab issue list	-
View issue	glab issue view <id>	-
Create issue	glab issue create	⚠️
Update issue	glab issue update <id>	⚠️
Close issue	glab issue close <id>	⚠️
Reopen issue	glab issue reopen <id>	⚠️
Delete issue	glab issue delete <id>	⚠️⚠️
Add note	glab issue note <id>	⚠️

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

When to Use This Skill

ALWAYS use when:

• User wants to work with issues
• User mentions "issue", "bug", "task", "ticket" or related terms
• User wants to track or manage work items

NEVER use when:

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

Available Commands

List Issues

glab issue list [options]

Options:

Flag	Description
-a, --assignee=<user>	Filter by assignee (use @me for yourself)
--author=<user>	Filter by author
-l, --label=<labels>	Filter by comma-separated labels
-m, --milestone=<milestone>	Filter by milestone
-s, --state=<state>	Filter by state: opened, closed, all (default: opened)
-c, --closed	Get only closed issues
--all	Get all issues
-P, --per-page=<n>	Number of items per page
--confidential	Filter to only confidential issues
--search=<query>	Search issues by title/description

Examples:

# List all open issues
glab issue list

# List issues assigned to you
glab issue list --assignee=@me

# List closed issues
glab issue list --closed

# List issues with specific label
glab issue list --label=bug

# List issues in a milestone
glab issue list --milestone="Release 1.0"

# Search issues
glab issue list --search="login bug"

# Get all issues (paginated)
glab issue list --all

View Issue Details

glab issue view <id> [options]

Options:

Flag	Description
-w, --web	Open issue in browser
-c, --comments	Show issue comments
-s, --system-logs	Show system activities

Examples:

# View issue in terminal
glab issue view 42

# Open issue in browser
glab issue view 42 --web

# View with comments
glab issue view 42 --comments

Create Issue

glab issue create [options]

Options:

Flag	Description
-t, --title=<title>	Issue title
-d, --description=<desc>	Issue description
-a, --assignee=<users>	Comma-separated assignees
-l, --label=<labels>	Comma-separated labels
-m, --milestone=<milestone>	Milestone title
--confidential	Create as confidential
--weight=<n>	Issue weight (0-9)
-w, --web	Open in browser after creation
-y, --yes	Skip confirmation prompts

Examples:

# Create issue with title
glab issue create -t "Fix login bug"

# Create issue with full details
glab issue create -t "Add dark mode" -d "Implement dark mode toggle" -l "enhancement,ui"

# Create issue with milestone and assignee
glab issue create -t "Release prep" -m "Release 2.0" -a "@me"

# Create confidential issue
glab issue create -t "Security vulnerability" --confidential

# Create and open in browser
glab issue create -t "New feature" --web

Update Issue

glab issue update <id> [options]

Options:

Flag	Description
-t, --title=<title>	Update title
-d, --description=<desc>	Update description
-a, --assignee=<users>	Update assignees
--unassign	Remove all assignees
-l, --label=<labels>	Add labels
--unlabel=<labels>	Remove labels
-m, --milestone=<milestone>	Set milestone
--confidential	Mark as confidential
--public	Mark as public
--lock-discussion	Lock discussion
--unlock-discussion	Unlock discussion

Examples:

# Update title
glab issue update 42 -t "Updated title"

# Add labels
glab issue update 42 -l "priority,reviewed"

# Remove labels
glab issue update 42 --unlabel="needs-review"

# Change assignee
glab issue update 42 -a "username"

# Add to milestone
glab issue update 42 -m "Sprint 5"

Close/Reopen Issue

# Close issue
glab issue close <id>

# Reopen issue
glab issue reopen <id>

Delete Issue

glab issue delete <id>

Warning: This permanently deletes the issue. Use with caution.

Add Note/Comment

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

Examples:

# Add comment
glab issue note 42 -m "Working on this now"

# Add closing comment
glab issue note 42 -m "Fixed in !123"

Subscribe/Unsubscribe

# Subscribe to issue notifications
glab issue subscribe <id>

# Unsubscribe
glab issue unsubscribe <id>

Common Workflows

Workflow 1: Triage Issues

# 1. List unassigned issues
glab issue list --assignee=""

# 2. View issue details
glab issue view 42

# 3. Assign and label
glab issue update 42 -a "developer" -l "bug,priority"

Workflow 2: Work on Issue

# 1. Find assigned issues
glab issue list --assignee=@me

# 2. View details
glab issue view 42

# 3. Create branch and work
git checkout -b fix/issue-42

# 4. Add progress note
glab issue note 42 -m "Started work on this"

# 5. Close when MR is merged
glab issue close 42

Workflow 3: Quick Bug Report

# Create issue with all details
glab issue create \
  -t "Login fails with special characters" \
  -d "Steps to reproduce:
1. Enter username with @ symbol
2. Click login
3. Error: 500

Expected: Login succeeds" \
  -l "bug,login"

Troubleshooting

Issue	Cause	Solution
Authentication failed	Invalid/expired token	Run glab auth login
Issue not found	Invalid ID or no access	Verify ID with glab issue list
Permission denied	Insufficient rights	Check project permissions
Cannot close	Issue is locked	Request unlock from maintainer

Related Documentation

• Safeguards
• Quick Reference