> ## Documentation Index
> Fetch the complete documentation index at: https://beads.gascity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# bd promote

> Promote a wisp to a permanent bead

Generated from `bd help --doc 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
```