Skip to content

bob freshness

Walk the tiered freshness review queue

bob freshness --help
Walk the tiered freshness review queue: list the tasks due for review in tier order PRE → NEW → PROJECTS → PENDING → NEXT → RECURRING → TICKLER → ROTTEN → POST.

The list subcommand is read-only: it evaluates every visible, non-recurring Ready, Pending, and Next task at read time — never stored — and shows the tiered walk queue with counts. Pending and Next tasks come due for a daily review set by freshness.pending_interval / next_interval. The hidden `seed` subcommand stamped the one-time cutover. Do not re-run it. See docs/freshness.md for the full definition.

Usage: bob freshness [OPTIONS] [COMMAND]

Commands:
  list  List the tiered freshness review queue (default)
  help  Print this message or the help of the given subcommand(s)

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

  -h, --help
          Print help (see a summary with '-h')

Examples:
  bob freshness
  bob freshness list -f json
  bob freshness list --limit 10
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json