beads/website/versioned_docs/version-1.0.4/cli-reference/children.md
matt wilkie a006a3369f fix(cli): implement children pretty and defer reason
Why: #4365 reports two documented CLI affordances that either fail or require a second command. children advertised --pretty but rejected it, and defer had no way to capture the reason at deferral time.

What: add the children --pretty flag by delegating to list's existing tree renderer, add defer --reason by appending to notes during the status update, and refresh generated CLI docs.

Agent-Signature: codex-unknown-model-unknown-reasoning on behalf of matt wilkie
2026-06-13 21:22:38 -07:00

779 B

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

Generated from bd help --doc children

bd children

List all beads that are children of the specified parent bead.

This is a convenience alias for 'bd list --parent <id> --status all'. Unlike plain 'bd list', children includes closed issues by default, since the primary use case is inspecting all work under a parent.

Examples: bd children hq-abc123 # List all children of hq-abc123 bd children hq-abc123 --json # List children in JSON format bd children hq-abc123 --pretty # Show children in tree format

bd children <parent-id> [flags]

Flags:

      --pretty   Show children in tree format