notes-inventory

Installation
SKILL.md

notes-inventory — the Notes sidebar as data

Self-Evolving skill — if macOS Notes' AppleScript behavior drifts from what's below (folder flattening, trash visibility, counts), fix this SKILL.md and the shared engine scripts/lib/notes-core.ts / scripts/notes.ts (+ a test in notes-core.test.ts); see the Post-Execution Reflection at the bottom.

Read-only survey of the whole Notes tree, across ALL accounts (iCloud, Google, Exchange…).

NC="$HOME/.claude/plugins/marketplaces/cc-skills/plugins/notes-commander/scripts/notes.ts"
bun "$NC" inventory            # human tree: account → folders (indented) with counts
bun "$NC" inventory --json     # [{account, path, count}, …] for analysis
  • Nested folders appear as paths with / separators (e.g. To-Do / Done) — folder names are not unique (two "Done" folders is normal), paths are.
  • Counts are direct notes per folder (subfolder notes count under the subfolder), matching the Notes sidebar.
  • Recently Deleted IS visible to AppleScript (verified live 2026-07-18) — inventory shows it but reports its notes separately from the live total; export skips it entirely.
  • First run may prompt once for Automation permission to control Notes; one AppleScript pass, so it's fast even on hundreds of notes.
  • If it fails with -600/"not running" repeatedly, open Notes once, then retry (the engine already retries transient errors).

This is the data source the notes-audit skill analyzes and the notes-organize skill acts on.

Installs
4
GitHub Stars
62
First Seen
Jul 24, 2026
notes-inventory — terrylica/cc-skills