Skip to content

bob plan

Show today's plan budget, Today's tasks, and NEXT/PENDING lanes

bob plan --help
Show today's Pomodoro plan budget from the daily note ledger, Today's tasks with a dedicated Task Link under today's open Pomodoros, and the NEXT/PENDING lane counts from the Tasks index.

The command is read-only. Themes are the distinct open Pomodoro names besides the exempt ones; links are the distinct Task Links under them. See docs/plan.md for the full definition. A missing daily note or missing Pomodoros section still reports TODAY 0 and the lanes, and exits 0.

Usage: bob plan [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

Examples:
  bob plan
  bob plan -f json
  bob plan -b ~/bob -f json

Environment:
  BOB_CONFIG_FILE         Exact Bob config file; defaults to ~/.config/bob/config.yml
  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
  NO_COLOR                  Disable colored output
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json