label

---

description: Manage issue labels argument-hint: "[command] [issue-id] [label]"

Manage labels on beads issues. Labels provide flexible cross-cutting metadata beyond structured fields (status, priority, type).

Available Commands

• add: Add a label to an issue

  • $1: "add"
  • $2: Issue ID
  • $3: Label name

• remove: Remove a label from an issue

  • $1: "remove"
  • $2: Issue ID
  • $3: Label name

• list: List labels on a specific issue

  • $1: "list"
  • $2: Issue ID

• list-all: Show all labels used across all issues

Common Label Use Cases

• Technical scope: backend, frontend, api, database
• Quality gates: needs-review, needs-tests, security-review
• Effort sizing: quick-win, complex, spike
• Context: technical-debt, documentation, performance

Use bd label add <issue-id> <label> to tag issues with contextual metadata.