Skip to content

bob capture-sections

List the non-Tasks sections of a capture note

bob capture-sections --help
List the existing non-Tasks Markdown sections of one routable Bob note.

The command is read-only and reports every ATX heading level (H1-H6) that Bob's bullet capture can target, in document order. Generated status-group headings under a Tasks heading (Next & In Progress, Blocked, Done & Canceled) are omitted. Missing notes are not errors; they return an empty list so picker callers can skip the section chooser.

Usage: bob capture-sections [OPTIONS]

Options:
  -b, --bob-dir <DIR>
          Bob vault root; defaults to BOB_DIR or ~/bob

  -f, --format <FORMAT>
          Output format: human or json

          [default: human]
          [possible values: human, json]

  -h, --help
          Show help

  -r, --route <NAME>
          Route/name of the capture note whose sections to list

Examples:
  bob capture-sections --route cash --format json
  bob capture-sections --route cash
  bob capture-sections -r cash -f json
  bob capture-sections -b ~/bob -r project-alpha
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json