Skip to content

bob projects

List and sync project notes via their ^prj tasks

bob projects --help
Manage Bob project notes through the completion-criteria task anchored with ^prj.

The list subcommand is read-only: it scans project notes, validates leftover scheduled: YYYY-MM-DD frontmatter and inline [scheduled:: YYYY-MM-DD] on ^prj, counts open #task items, counts open non-hidden tasks, and shows the current ^prj state. A `rollup: subprojects` project is marked `rollup` in the list output; invalid rollup values are warned about without changing its exit status. The sync subcommand updates project status, hoists leftover frontmatter scheduled onto ^prj, propagates that date onto ordinary tasks, and manages the single Sub-projects line from the ^prj task.

Usage: bob projects <COMMAND>

Commands:
  list  List project notes, ^prj task state, and reporting rollups
  sync  Sync project status, task schedules, and sub-projects
  help  Print this message or the help of the given subcommand(s)

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

Examples:
  bob projects list
  bob projects sync --dry-run
  bob projects sync -b ~/bob
Tested rolling snapshot bob-cli 41afa14 bob-mac-capture 556bb67 bob-plugins af1e691 Built 2026-10-24T22:34:13Z (zensical) build.json