Back to Beads

Labels & Comments

website/versioned_docs/version-1.0.0/cli-reference/labels.md

1.0.32.2 KB
Original Source

Labels & Comments

Commands for managing labels and comments.

Labels

Adding Labels

bash
# During creation
bd create "Task" -l "backend,urgent"

# To existing issue
bd update bd-42 --add-label urgent
bd update bd-42 --add-label "backend,security"

Removing Labels

bash
bd update bd-42 --remove-label urgent

Listing Labels

bash
# All labels in use
bd label list
bd label list --json

# Issues with specific labels
bd list --label-any urgent,critical
bd list --label-all backend,security

Label Conventions

Suggested label categories:

CategoryExamplesPurpose
Typebug, feature, docsIssue classification
Priorityurgent, criticalUrgency markers
Areabackend, frontend, apiCode area
Statusblocked, needs-reviewWorkflow state
Sizesmall, medium, largeEffort estimate

Comments

Adding Comments

bash
bd comment add bd-42 "Working on this now"
bd comment add bd-42 --message "Found the bug in auth.go:45"

Listing Comments

bash
bd comment list bd-42
bd comment list bd-42 --json

Viewing with Issue

bash
bd show bd-42 --full  # Includes comments

Filtering by Labels

Any Match (OR)

bash
# Issues with urgent OR critical
bd list --label-any urgent,critical

All Match (AND)

bash
# Issues with BOTH backend AND security
bd list --label-all backend,security

Combined Filters

bash
# Open bugs with urgent label
bd list --status open --type bug --label-any urgent --json

Bulk Operations

Add Label to Multiple Issues

bash
# Using shell
for id in bd-42 bd-43 bd-44; do
  bd update $id --add-label "sprint-1"
done

Find and Label

bash
# Label all open bugs as needs-triage
bd list --status open --type bug --json | \
  jq -r '.[].id' | \
  xargs -I {} bd update {} --add-label needs-triage

Best Practices

  1. Keep labels lowercase - backend not Backend
  2. Use hyphens for multi-word - needs-review not needs_review
  3. Be consistent - Establish team conventions
  4. Don't over-label - 2-4 labels per issue is typical
  5. Review periodically - Remove unused labels