beads/website/versioned_docs/version-1.0.0/cli-reference/issues.md
Isaac Karrer 7f0a165f4e
feat(docs): version Docusaurus site and align llms-full with snapshots (#3033)
* feat(docs): version Docusaurus site and align llms-full with snapshots

Add docs version 1.0.0, version dropdown, lastVersion defaulting to stable,
merged markdown config, and RELEASING steps for future doc snapshots.
generate-llms-full.sh reads the latest entry in versions.json.

README links the published documentation site.

Closes #2644

Made-with: Cursor

* fix(docs): update org URLs to gastownhall and refresh 1.0.0 snapshot

- Update default orgName in docusaurus.config.ts from steveyegge to
  gastownhall to match the repo's new home
- Update hardcoded steveyegge URLs in generate-llms-full.sh
- Refresh versioned_docs 1.0.0 snapshot to include quickstart changes
  from #3032 which merged after the original snapshot was taken
- Regenerate llms-full.txt with corrected URLs and updated content

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: matt wilkie <maphew@gmail.com>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 21:12:54 -07:00

4.1 KiB

id title sidebar_position
issues Issue Commands 3

Issue Commands

Commands for managing issues.

bd create

Create a new issue.

bd create <title> [flags]

All flags:

--type, -t        Issue type (bug|feature|task|epic|chore)
--priority, -p    Priority 0-4
--description, -d Detailed description
--design          Design notes
--acceptance      Acceptance criteria
--notes           Additional notes
--labels, -l      Comma-separated labels
--parent          Parent issue ID
--deps            Dependencies (type:id format)
--assignee        Assigned user
--json            JSON output

Examples:

# Bug with high priority
bd create "Login fails with special chars" -t bug -p 1

# Feature with description
bd create "Add export to PDF" -t feature -p 2 \
  --description="Users want to export reports as PDF files"

# Feature with design, acceptance, and notes
bd create "Implement user authentication" -t feature -p 1 \
  --description="Add JWT-based authentication" \
  --design="Use bcrypt for password hashing, JWT for sessions" \
  --acceptance="All tests pass, security audit complete" \
  --notes="Consider rate limiting for login attempts"

# Task with labels
bd create "Update CI config" -t task -l "ci,infrastructure"

# Epic with children
bd create "Auth System" -t epic -p 1
bd create "Design login UI" --parent bd-42
bd create "Implement backend" --parent bd-42

# Discovered issue
bd create "Found SQL injection" -t bug -p 0 \
  --deps discovered-from:bd-42 --json

bd show

Display issue details.

bd show <id>... [flags]

Flags:

--full        Show all fields including comments
--json        JSON output

Examples:

bd show bd-42
bd show bd-42 --full
bd show bd-42 bd-43 bd-44 --json

bd update

Update issue fields.

bd update <id> [flags]

All flags:

--status          New status (open|in_progress|closed)
--priority        New priority (0-4)
--title           New title
--description     New description
--type            New type
--add-label       Add label(s)
--remove-label    Remove label(s)
--assignee        New assignee
--json            JSON output

Examples:

# Start work
bd update bd-42 --claim

# Escalate priority
bd update bd-42 --priority 0 --add-label urgent

# Change title and description
bd update bd-42 --title "New title" --description="Updated description"

# Multiple changes
bd update bd-42 --claim --priority 1 --add-label "in-review" --json

bd close

Close an issue.

bd close <id> [flags]

Flags:

--reason    Closure reason (stored in comment)
--json      JSON output

Examples:

bd close bd-42
bd close bd-42 --reason "Fixed in commit abc123"
bd close bd-42 --reason "Duplicate of bd-43" --json

bd reopen

Reopen a closed issue.

bd reopen <id> [flags]

Examples:

bd reopen bd-42
bd reopen bd-42 --json

bd delete

Delete an issue.

bd delete <id> [flags]

Flags:

--force, -f    Skip confirmation
--json         JSON output

Examples:

bd delete bd-42
bd delete bd-42 -f --json

Note: Deletions are tracked in the Dolt database for sync.

Search issues by text.

bd search <query> [flags]

Flags:

--status    Filter by status
--type      Filter by type
--json      JSON output

Examples:

bd search "authentication"
bd search "login bug" --status open
bd search "API" --type feature --json

bd duplicates

Find and manage duplicate issues.

bd duplicates [flags]

Flags:

--auto-merge    Automatically merge all duplicates
--dry-run       Preview without changes
--json          JSON output

Examples:

bd duplicates
bd duplicates --auto-merge
bd duplicates --dry-run --json

bd merge

Merge duplicate issues.

bd merge <source>... --into <target> [flags]

Flags:

--into      Target issue to merge into
--dry-run   Preview without changes
--json      JSON output

Examples:

bd merge bd-42 bd-43 --into bd-41
bd merge bd-42 bd-43 --into bd-41 --dry-run --json