beads/website/versioned_docs/version-1.0.4/cli-reference/promote.md
matt wilkie c97c416242
docs: publish v1.0.4 docs snapshot (#3845)
* docs: publish v1.0.4 docs snapshot

* release: guard docs version snapshots
2026-05-09 14:42:25 -07:00

735 B

id title slug sidebar_position
promote bd promote /cli-reference/promote 999

Generated from bd help --doc promote

bd promote

Promote a wisp (ephemeral issue) to a permanent bead.

This copies the issue from the wisps table (dolt_ignored) to the permanent issues table (Dolt-versioned), preserving labels, dependencies, events, and comments. The original ID is preserved so all links keep working.

A comment is added recording the promotion and optional reason.

Examples: bd promote bd-wisp-abc123 bd promote bd-wisp-abc123 --reason "Worth tracking long-term"

bd promote <wisp-id> [flags]

Flags:

  -r, --reason string   Reason for promotion