How do I install the Notes Inventory skill?

Run npx skillmds add terrylica/notes-inventory in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Notes Inventory safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: docs only. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Notes Inventory?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Notes Inventory free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Notes Inventory?

terrylica (@terrylica) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Notes Inventory by terrylica — Agent Skill

Name: Notes Inventory
Rating: 4.666666666666667 (3 reviews)
Author: terrylica

Notes Inventory

List every macOS Notes account, folder (including nested subfolders), and per-folder note count — the sidebar as machine-readable data. Use to see what exists before organizing, to answer "how many notes are in X", or as the first step of an audit/export. Read-only, safe. TRIGGERS - list my notes folders, notes inventory, how many notes, what folders do I have, show my notes structure.

terrylica 3f382d0 2.4 KB Updated Sep 9, 2026

File contents

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.

Post-Execution Reflection

After an inventory run, check: (1) did the tree match the Notes sidebar (folders, nesting, counts)? If not, the flattened-folders of account filter or trash handling drifted — fix OSA_INVENTORY in scripts/notes.ts and document the macOS change here. (2) Did a transient -600/-1712 require a manual retry? If the built-in retry didn't absorb it, tune runOsa in notes-core.ts. Only update for real, reproducible drift — not speculation.

---name: notes-inventorydescription: List every macOS Notes account, folder (including nested subfolders), and per-folder note count — the sidebar as machine-readable data. Use to see what exists before organizing, to answer "how many notes are in X", or as the first step of an audit/export. Read-only, safe. TRIGGERS - list my notes folders, notes inventory, how many notes, what folders do I have, show my notes structure.--- # 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…). ```bash 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. ## Post-Execution Reflection After an inventory run, check: (1) did the tree match the Notes sidebar (folders, nesting, counts)? If not, the flattened-`folders of account` filter or trash handling drifted — fix `OSA_INVENTORY` in `scripts/notes.ts` and document the macOS change here. (2) Did a transient `-600`/`-1712` require a manual retry? If the built-in retry didn't absorb it, tune `runOsa` in `notes-core.ts`. Only update for real, reproducible drift — not speculation.

Frequently asked questions