glab-issue

name	glab-issue
description	Create, view, update, and manage GitLab issues. Use when working with issue tracking, bug reports, feature requests, or task management. Operations include creating issues, listing with filters, viewing details, adding comments/notes, updating labels/assignees/milestones, closing/reopening, and board management. Triggers on issue, bug, task, ticket, feature request, list issues, create issue.

glab issue

Create, view, update, and manage GitLab issues.

Quick start

# Create an issue
glab issue create --title "Fix login bug" --label bug

# List open issues
glab issue list --state opened

# View issue details
glab issue view 123

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

# Close issue
glab issue close 123

Common workflows

Bug reporting workflow

1. Create bug issue:

   glab issue create \
     --title "Login fails with 500 error" \
     --label bug \
     --label priority::high \
     --assignee @dev-lead
   

2. Add reproduction steps:

   glab issue note 456 -m "Steps to reproduce:
   1. Navigate to /login
   2. Enter valid credentials
   3. Click submit
   Expected: Dashboard loads
   Actual: 500 error"
   

Issue triage

1. List untriaged issues:

   glab issue list --label needs-triage --state opened
   

2. Update labels and assignee:

   glab issue update 789 \
     --label backend,priority::medium \
     --assignee @backend-team \
     --milestone "Sprint 23"
   

3. Remove triage label:

   glab issue update 789 --unlabel needs-triage
   

Batch labeling:

For applying labels to multiple issues at once:

scripts/batch-label-issues.sh "priority::high" 100 101 102
scripts/batch-label-issues.sh bug 200 201 202 203

Sprint planning

View current sprint issues:

glab issue list --milestone "Sprint 23" --assignee @me

Add to sprint:

glab issue update 456 --milestone "Sprint 23"

Board view:

glab issue board view

Linking issues to work

Create MR for issue:

glab mr for 456  # Creates MR that closes issue #456

Automated workflow (create branch + draft MR):

scripts/create-mr-from-issue.sh 456 --create-mr

This automatically: creates branch from issue title → empty commit → pushes → creates draft MR.

Close via commit/MR:

git commit -m "Fix login bug

Closes #456"

Related Skills

Creating MRs from issues:

• See glab-mr for merge request operations
• Use glab mr for <issue-id> to create MR that closes issue
• Script: scripts/create-mr-from-issue.sh automates branch creation + draft MR

Label management:

• See glab-label for creating and managing labels
• Script: scripts/batch-label-issues.sh for bulk labeling operations

Project planning:

• See glab-milestone for release planning
• See glab-iteration for sprint/iteration management

Command reference

For complete command documentation and all flags, see references/commands.md.

Available commands:

• create - Create new issue
• list - List issues with filters
• view - Display issue details
• note - Add comment to issue
• update - Update title, labels, assignees, milestone
• close - Close issue
• reopen - Reopen closed issue
• delete - Delete issue
• subscribe / unsubscribe - Manage notifications
• board - Work with issue boards