Skip to content

bob capture-pomodoros

List today's Pomodoro ledger entries

bob capture-pomodoros --help
List Pomodoro entries from today's Bob daily note.

The command is read-only and reports Pomodoros in document order with stable refs, names, selector slugs, time ranges, current-session status, child link counts, and the current entry's numbered Task Link count for picker callers. Open entries are listed by default; use --all to include completed entries. A missing daily note or missing Pomodoros section returns a successful empty list with a warning.

With --tasks, each listed entry also carries its agenda payload: the entry role, naive start/end datetimes, the retired-link count, session notes, the resolved Task Link lineup with operator numbers, clean titles, statuses, task-block lines, and ledger notes, and a derived homes object from those Task Links. Every named entry carries its component ThemeRefs in `themes`. Human output appends a dim home chip with its forecast or attributed dot after each entry name. Its optional plan_budget is computed from the saved daily note and the configured plan limits.

Usage: bob capture-pomodoros [OPTIONS]

Options:
  -a, --all
          Include completed Pomodoro entries

  -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

  -t, --tasks
          Resolve each open entry's Task Links into tasks for agenda views (roles, operator numbers, task blocks)

Examples:
  bob capture-pomodoros --format json
  bob capture-pomodoros
  bob capture-pomodoros --all
  bob capture-pomodoros -f json
  bob capture-pomodoros -b ~/bob -a -f json
  bob capture-pomodoros -t -f json

Environment:
  BOB_DAY_FILE              Daily note override; otherwise <bob-dir>/YYYY/YYYYMMDD.md
  BOB_DIR                   Bob vault root when --bob-dir is omitted
  BOB_NOW                   Local datetime override for default daily-note selection
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json