beads/website/docs/cli-reference
Steve Yegge 672d942083
fix(label): support comma-separated multi-label add/remove; fail hard on bad issue IDs (#4713)
* fix(label): support comma-separated multi-label add/remove; fail hard on bad issue IDs (bd-vu5kv)

'bd label add <id> a b c' silently applied only 'c': the grammar treats
the last arg as THE label and everything before it as issue IDs, and
unresolvable IDs were skipped with a stderr warning while the command
exited 0. An agent hit this in the wild and only noticed because
'bd ready --label ...' came back empty.

Two changes:

- The final positional arg now splits on commas, so
  'bd label add bd-123 a,b,c' adds all three labels in one transaction
  (same convention as 'bd create --labels a,b,c'). Same for remove.
- Issue-ID args that fail to resolve are now a hard error before any
  mutation, instead of warn-and-continue. When several ID-position args
  fail, the error hints at the comma-separated form, which is exactly
  the space-separated-labels mistake.

The reserved 'provides:' check now runs against every label in the
list. Regenerated CLI reference docs (freshness probe) and updated
docs/LABELS.md.

Closes bd-vu5kv

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012VBUR4qkHbssPomBDuJgkQ

* docs: sync website label mirrors

Agent-Signature: codex-gpt-5.6-terra-high on behalf of matt wilkie

---------

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Co-authored-by: matt wilkie <maphew@gmail.com>
2026-07-12 08:23:52 -07:00
..
admin.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
ado.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
assign.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
audit.md fix(audit): make JSONL sidecar opt-in (#4688) 2026-07-11 00:09:17 -07:00
backup.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
batch.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
blocked.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
bootstrap.md fix(init): use git origin as default Dolt remote (#3909) 2026-05-13 07:02:39 -07:00
branch.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
children.md fix(cli): implement children pretty and defer reason 2026-06-13 21:22:38 -07:00
close.md fix(close): support per-id reasons (#4194) 2026-05-27 20:41:07 -07:00
comment.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
comments.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
compact.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
completion.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
config.md fix(config): derive tracker config namespaces from the registry (#4428) 2026-07-08 10:30:25 -07:00
context.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
cook.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
count.md feat(count): add --include-infra for exact bd list cardinality parity (#4389) 2026-06-13 04:14:28 -07:00
create-form.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
create.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
defer.md fix(cli): implement children pretty and defer reason 2026-06-13 21:22:38 -07:00
delete.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
dep.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
diff.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
doctor.md fix(init): use git origin as default Dolt remote (#3909) 2026-05-13 07:02:39 -07:00
dolt.md docs: regenerate CLI reference after clean-databases prefix-list change (#4631) 2026-07-07 09:28:10 -07:00
duplicate.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
duplicates.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
edit.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
epic.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
export.md feat(prune): reference-aware bd prune skips closed beads cited by open beads (be-jewoem, be-u2mw2x) (#4023) 2026-07-05 15:57:27 -07:00
federation.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
find-duplicates.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
flatten.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
forget.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
formula.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
gate.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
gc.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
github.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
gitlab.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
graph.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
heartbeat.md feat(lease): land the leasing stack + schema v54 (claim-TTL, heartbeat, reclaim) (#4537) 2026-07-03 23:28:55 -07:00
history.md fix(audit): make JSONL sidecar opt-in (#4688) 2026-07-11 00:09:17 -07:00
hooks.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
human.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
import.md feat(count): add --include-infra for exact bd list cardinality parity (#4389) 2026-06-13 04:14:28 -07:00
index.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
info.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
init-safety.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
init.md feat(cursor): bring Cursor integration to parity with Claude/Codex (#4649) 2026-07-10 13:10:46 -07:00
jira.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
kv.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
label.md fix(label): support comma-separated multi-label add/remove; fail hard on bad issue IDs (#4713) 2026-07-12 08:23:52 -07:00
linear.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
link.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
lint.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
list.md Fix rig bead durability (#4373) 2026-06-22 17:06:35 -07:00
mail.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
memories.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
merge-slot.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
metrics.md fix(cli): handle unchecked output-helper errors + regen metrics CLI docs (#4482) 2026-06-23 02:18:01 -07:00
migrate-personal.md feat(prune): reference-aware bd prune skips closed beads cited by open beads (be-jewoem, be-u2mw2x) (#4023) 2026-07-05 15:57:27 -07:00
migrate.md feat(migrate): add --force flag as CLI twin of BD_ALLOW_REMOTE_MIGRATE (#4654) 2026-07-07 15:58:18 -07:00
mol.md fix(cli): register --gated flag on bd mol ready subcommand (#3744) 2026-07-07 06:42:43 -07:00
note.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
notion.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
onboard.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
orphans.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
ping.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
preflight.md feat(preflight): implement --fix mode for vendorHash and version sync (#4054) 2026-07-06 22:33:29 -07:00
prime.md docs: regenerate CLI reference for agent.profile config key 2026-07-07 13:52:51 -07:00
priority.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
promote.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
prune.md feat(prune): reference-aware bd prune skips closed beads cited by open beads (be-jewoem, be-u2mw2x) (#4023) 2026-07-05 15:57:27 -07:00
purge.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
q.md feat(q): add --parent for hierarchical quick capture (#4597) 2026-07-07 05:50:25 -07:00
query.md /docs: regen CLI reference for bd query --offset flag 2026-06-24 14:47:29 -07:00
quickstart.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
ready.md docs: regenerate CLI reference for bd ready --offset 2026-06-18 13:55:12 -07:00
recall.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
reclaim.md feat(lease): land the leasing stack + schema v54 (claim-TTL, heartbeat, reclaim) (#4537) 2026-07-03 23:28:55 -07:00
recompute-blocked.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
remember.md docs(cli): regenerate CLI reference for bd remember bare-key reads (#4545) 2026-07-02 09:14:33 -07:00
rename-prefix.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
rename.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
reopen.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
repo.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
restore.md fix(compact): archive content before destructive compaction; make restore work (#4464) 2026-06-20 14:12:07 -07:00
rules.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
search.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
set-state.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
setup.md feat(cursor): bring Cursor integration to parity with Claude/Codex (#4649) 2026-07-10 13:10:46 -07:00
ship.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
show.md feat(show): count-only JSON details with opt-in streamed payloads 2026-05-22 16:54:15 -07:00
sql.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
stale.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
state.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
status.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
statuses.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
supersede.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
swarm.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
tag.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
todo.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
types.md docs: regenerate CLI reference (fixes doc-flags-freshness after #4613) (#4616) 2026-07-06 23:03:41 -07:00
unclaim.md feat: add bd unclaim command to release stuck issues (replaces #3694) (#4614) 2026-07-06 22:51:35 -07:00
undefer.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
update.md docs: generate CLI reference from live help (#3704) 2026-05-05 19:43:49 -07:00
upgrade.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
vc.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
version.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
where.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00
worktree.md fix(docgen): generate CLI docs in one process (#4474) 2026-06-22 18:25:58 -07:00