bob ready¶

Show each area/project note's Ready lane against the per-note cap. The Ready lane is visible, pullable [ ] tasks whatever their freshness (dash READY also hides NEW and ROTTEN). A note is crowded above its cap, full at it, and has room below it.

The command is read-only. Crowded notes never fail the report; only --check maps them to an exit code. See docs/plan.md for the full definition.

Usage: bob ready [OPTIONS] [NOTE]

Arguments:
  [NOTE]
          List one note's lane tasks (vault path, or note name)

Options:
  -a, --all
          Also list room notes in full, empty, exempt, and done projects

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

  -n, --cap <N>
          Preview a different default cap (1-999) for this run only

  -c, --check
          Exit 3 when any note is crowded (for scripts and tmux)

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

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

  -h, --help
          Print help

Examples:
  bob ready
  bob ready sase_remote
  bob ready -a
  bob ready -n 7
  bob ready -c -f json

Environment:
  BOB_CONFIG_FILE         Exact Bob config file; defaults to ~/.config/bob/config.yml
  BOB_DIR                   Bob vault root when --bob-dir is omitted
  BOB_NOW                   Local datetime override for review date selection
  NO_COLOR                  Disable colored output

Exit codes:
  0  report (even when notes are crowded)
  1  vault I/O failure
  2  invalid plan.max_ready_per_note, non-Dataview task format, or unresolvable note
  3  --check and at least one note is crowded

Overrides:
  ready_cap:              Per-note frontmatter cap (1-999) or off; invalid values lint once per note and fall back to the default