GitHub Labels

Reference for discovering and applying labels to GitHub PRs and issues.

Discovering Available Labels

# List all labels with details
gh label list --json name,description,color --limit 50

# Search for specific labels
gh label list --search "bug"

# Output as simple list
gh label list --json name -q '.[].name'

Adding Labels to PRs

# Single label
gh pr create --label "bug"

# Multiple labels (repeat flag)
gh pr create --label "bug" --label "priority:high"

# Comma-separated
gh pr create --label "bug,priority:high"

# Add to existing PR
gh pr edit 123 --add-label "ready-for-review"

Adding Labels to Issues

# Create with labels
gh issue create --label "bug,needs-triage"

# Add to existing issue
gh issue edit 123 --add-label "in-progress"

# Remove label
gh issue edit 123 --remove-label "needs-triage"

Common Label Categories

| Category | Examples | |----------|----------| | Type | bug, feature, enhancement, documentation, chore | | Priority | priority:critical, priority:high, priority:medium, priority:low | | Status | needs-triage, in-progress, blocked, ready-for-review | | Area | frontend, backend, infrastructure, testing, ci-cd |

Label Inheritance Pattern

When creating a PR from an issue:

Read issue labels via gh issue view N --json labels
Apply same labels to PR: gh pr create --label "label1,label2"

This maintains traceability and consistent categorization.