fsnotes

olomix-cc-thingz

A personal Claude Code plugin marketplace. It currently ships one plugin, fsnotes.

fsnotes

Lets Claude search, create, edit, and delete notes managed by the FSNotes macOS/iOS app through natural requests — "find my note about X", "make a note", "add to my X note", "delete that note".

FSNotes keeps each note as a plain Markdown file in iCloud, with a few conventions Claude would otherwise have to guess. This plugin teaches it the layout so it operates on the store reliably:

• Notes are .markdown files (not .md).
• The first line is a # Title heading; the filename usually matches.
• Subfolders are notebooks. Notebook names are discovered at runtime — none are hardcoded.
• Tags are inline #hashtags in the body; there is no YAML frontmatter.
• Trash/ (deleted notes) and files/ (attachments) are reserved and are excluded from searches.

The actual logic lives in small, deterministic shell scripts under plugins/fsnotes/scripts/, so it can be unit-tested:

• fsnotes-search.sh <mode> <query> [notebook] — search by text, title, or tag, with an optional [notebook] scoping any mode to one subfolder. folder is a body search scoped to a notebook and instead takes its arguments as fsnotes-search.sh folder <notebook> <query>.
• fsnotes-newpath.sh <title> [notebook] — print a safe, collision-free path for a new note (never overwrites).
• fsnotes-trash.sh <note-path> — move a note into Trash/ (never hard-deletes).
• fsnotes-lib.sh — shared helpers, sourced by the others.

A fsnotes-search subagent and the fsnotes skill wire these together so Claude picks the right operation and returns compact results.

Install

/plugin marketplace add olomix/cc-thingz
/plugin install fsnotes

Recommended: ripgrep

Search uses ripgrep (rg) when available and falls back to grep -r otherwise, emitting a one-time hint to install it. For best performance:

brew install ripgrep

Notes directory resolution

The scripts locate the FSNotes store in this order:

1. $FSNOTES_DIR, if set and existing.
2. The iCloud primary path ~/Library/Mobile Documents/iCloud~co~fluder~fsnotes/Documents.
3. A glob of ~/Library/Mobile Documents/*fsnotes*/Documents (used only when it resolves to exactly one match).

The FSNOTES_DIR override exists so the test suite can target a temporary fixture directory; in normal use it is unset and the iCloud path applies.

Development

shellcheck tests/fsnotes_test.sh plugins/fsnotes/scripts/*.sh
tests/fsnotes_test.sh

Tests are pure bash with no external framework. They build a temporary fixture store via FSNOTES_DIR and never touch the real iCloud notes.

License

MIT — see LICENSE.