website/docs/cli-reference/labels.md
Commands for managing labels and comments.
# 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"
bd update bd-42 --remove-label urgent
# 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
Suggested label categories:
| Category | Examples | Purpose |
|---|---|---|
| Type | bug, feature, docs | Issue classification |
| Priority | urgent, critical | Urgency markers |
| Area | backend, frontend, api | Code area |
| Status | blocked, needs-review | Workflow state |
| Size | small, medium, large | Effort estimate |
bd comment add bd-42 "Working on this now"
bd comment add bd-42 --message "Found the bug in auth.go:45"
bd comment list bd-42
bd comment list bd-42 --json
bd show bd-42 --full # Includes comments
# Issues with urgent OR critical
bd list --label-any urgent,critical
# Issues with BOTH backend AND security
bd list --label-all backend,security
# Open bugs with urgent label
bd list --status open --type bug --label-any urgent --json
# Using shell
for id in bd-42 bd-43 bd-44; do
bd update $id --add-label "sprint-1"
done
# 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
backend not Backendneeds-review not needs_review