beads/website/docs/cli-reference/q.md
Kevin Glynn c36afd74e1
feat(q): add --parent for hierarchical quick capture (#4597)
bd q is designed for scripting and agent integration, but batch-creating
epic breakdowns required falling back to the heavier bd create --parent.

Mirrors create.go's parent handling: validate the parent exists, inherit
its labels (create's default), reserve the hierarchical child ID via
GetNextChildID/WithReservedChildCounter, add the parent-child dependency
after CreateIssue, and follow up with the post-write Dolt commit
(GH#2009 pattern). Output stays ID-only.

Closes #4596

Assisted-by: Claude:claude-fable-5 [Cursor]

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-07 05:50:25 -07:00

814 B

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

Generated from bd help --doc q

bd q

Quick capture creates an issue and outputs only the issue ID. Designed for scripting and AI agent integration.

Example: bd q "Fix login bug" # Outputs: bd-a1b2 ISSUE=$(bd q "New feature") # Capture ID in variable bd q "Task" | xargs bd show # Pipe to other commands bd q "Subtask" --parent=bd-a1b2 # Hierarchical child (outputs: bd-a1b2.1)

bd q [title] [flags]

Flags:

  -l, --labels strings    Labels
      --parent string     Parent issue ID for hierarchical child (e.g., 'bd-a3f8e9')
  -p, --priority string   Priority (0-4 or P0-P4) (default "2")
  -t, --type string       Issue type (default "task")