* docs: generate CLI reference from live help * docs(cli): move bd version stamp from per-command pages to index only Drops the `(bd version X.Y.Z)` suffix from the auto-generated header on every per-command CLI reference page (writeSingleCommandDoc) and the docs/CLI_REFERENCE.md preamble (writeAllHelp). The version label now lives only on the index page emitted by scripts/generate-cli-docs.sh: - Dev tree (website/docs/cli-reference/index.md, docs/CLI_REFERENCE.md): labelled "Latest" - Versioned snapshots (website/versioned_docs/version-X.Y.Z/...): labelled with the explicit semver tag parsed from the directory name This eliminates the 100+-file no-signal diff a release version bump otherwise produces, restoring the "regen as a separate small commit" workflow PR #3704 enables. After this change a version bump alone yields zero diff on the dev tree; only the new versioned snapshot created at release-cut time carries the new tag. No datestamps are introduced anywhere — scripts/generate-cli-docs.sh --check remains deterministic across CI runs. Refs: mybd-afb, PR #3704 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com> --------- Co-authored-by: CI Bot <ci@beads.test> Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
125 lines
3.3 KiB
Markdown
125 lines
3.3 KiB
Markdown
---
|
|
id: index
|
|
title: CLI Reference
|
|
sidebar_position: 0
|
|
---
|
|
|
|
# CLI Reference
|
|
|
|
<!-- AUTO-GENERATED: do not edit manually -->
|
|
Reference for bd Latest. Generated from `bd help --list` and `bd help --doc <command>`.
|
|
|
|
This reference covers all 106 live top-level `bd` commands. Regenerate it with:
|
|
|
|
```bash
|
|
./scripts/generate-cli-docs.sh
|
|
```
|
|
|
|
## Commands
|
|
|
|
- [`bd admin`](./admin.md)
|
|
- [`bd ado`](./ado.md)
|
|
- [`bd assign`](./assign.md)
|
|
- [`bd audit`](./audit.md)
|
|
- [`bd backup`](./backup.md)
|
|
- [`bd batch`](./batch.md)
|
|
- [`bd blocked`](./blocked.md)
|
|
- [`bd bootstrap`](./bootstrap.md)
|
|
- [`bd branch`](./branch.md)
|
|
- [`bd children`](./children.md)
|
|
- [`bd close`](./close.md)
|
|
- [`bd comment`](./comment.md)
|
|
- [`bd comments`](./comments.md)
|
|
- [`bd compact`](./compact.md)
|
|
- [`bd completion`](./completion.md)
|
|
- [`bd config`](./config.md)
|
|
- [`bd context`](./context.md)
|
|
- [`bd cook`](./cook.md)
|
|
- [`bd count`](./count.md)
|
|
- [`bd create`](./create.md)
|
|
- [`bd create-form`](./create-form.md)
|
|
- [`bd defer`](./defer.md)
|
|
- [`bd delete`](./delete.md)
|
|
- [`bd dep`](./dep.md)
|
|
- [`bd diff`](./diff.md)
|
|
- [`bd doctor`](./doctor.md)
|
|
- [`bd dolt`](./dolt.md)
|
|
- [`bd duplicate`](./duplicate.md)
|
|
- [`bd duplicates`](./duplicates.md)
|
|
- [`bd edit`](./edit.md)
|
|
- [`bd epic`](./epic.md)
|
|
- [`bd export`](./export.md)
|
|
- [`bd federation`](./federation.md)
|
|
- [`bd find-duplicates`](./find-duplicates.md)
|
|
- [`bd flatten`](./flatten.md)
|
|
- [`bd forget`](./forget.md)
|
|
- [`bd formula`](./formula.md)
|
|
- [`bd gate`](./gate.md)
|
|
- [`bd gc`](./gc.md)
|
|
- [`bd github`](./github.md)
|
|
- [`bd gitlab`](./gitlab.md)
|
|
- [`bd graph`](./graph.md)
|
|
- [`bd history`](./history.md)
|
|
- [`bd hooks`](./hooks.md)
|
|
- [`bd human`](./human.md)
|
|
- [`bd import`](./import.md)
|
|
- [`bd info`](./info.md)
|
|
- [`bd init`](./init.md)
|
|
- [`bd init-safety`](./init-safety.md)
|
|
- [`bd jira`](./jira.md)
|
|
- [`bd kv`](./kv.md)
|
|
- [`bd label`](./label.md)
|
|
- [`bd linear`](./linear.md)
|
|
- [`bd link`](./link.md)
|
|
- [`bd lint`](./lint.md)
|
|
- [`bd list`](./list.md)
|
|
- [`bd mail`](./mail.md)
|
|
- [`bd memories`](./memories.md)
|
|
- [`bd merge-slot`](./merge-slot.md)
|
|
- [`bd migrate`](./migrate.md)
|
|
- [`bd mol`](./mol.md)
|
|
- [`bd note`](./note.md)
|
|
- [`bd notion`](./notion.md)
|
|
- [`bd onboard`](./onboard.md)
|
|
- [`bd orphans`](./orphans.md)
|
|
- [`bd ping`](./ping.md)
|
|
- [`bd preflight`](./preflight.md)
|
|
- [`bd prime`](./prime.md)
|
|
- [`bd priority`](./priority.md)
|
|
- [`bd promote`](./promote.md)
|
|
- [`bd prune`](./prune.md)
|
|
- [`bd purge`](./purge.md)
|
|
- [`bd q`](./q.md)
|
|
- [`bd query`](./query.md)
|
|
- [`bd quickstart`](./quickstart.md)
|
|
- [`bd ready`](./ready.md)
|
|
- [`bd recall`](./recall.md)
|
|
- [`bd remember`](./remember.md)
|
|
- [`bd rename`](./rename.md)
|
|
- [`bd rename-prefix`](./rename-prefix.md)
|
|
- [`bd reopen`](./reopen.md)
|
|
- [`bd repo`](./repo.md)
|
|
- [`bd restore`](./restore.md)
|
|
- [`bd rules`](./rules.md)
|
|
- [`bd search`](./search.md)
|
|
- [`bd set-state`](./set-state.md)
|
|
- [`bd setup`](./setup.md)
|
|
- [`bd ship`](./ship.md)
|
|
- [`bd show`](./show.md)
|
|
- [`bd sql`](./sql.md)
|
|
- [`bd stale`](./stale.md)
|
|
- [`bd state`](./state.md)
|
|
- [`bd status`](./status.md)
|
|
- [`bd statuses`](./statuses.md)
|
|
- [`bd supersede`](./supersede.md)
|
|
- [`bd swarm`](./swarm.md)
|
|
- [`bd tag`](./tag.md)
|
|
- [`bd todo`](./todo.md)
|
|
- [`bd types`](./types.md)
|
|
- [`bd undefer`](./undefer.md)
|
|
- [`bd update`](./update.md)
|
|
- [`bd upgrade`](./upgrade.md)
|
|
- [`bd vc`](./vc.md)
|
|
- [`bd version`](./version.md)
|
|
- [`bd where`](./where.md)
|
|
- [`bd worktree`](./worktree.md)
|