Agent skill · software engineering · jeremylongshore
apple-notes-webhooks-events
Monitor Apple Notes changes using file system events and Shortcuts triggers.
Why this skill is useful
Adds specific scripts for monitoring Apple Notes changes using file system events and automation that the AI wouldn't reliably generate on its own.
What it needs
Requires fswatch installed locally. About 4k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apple Notes Webhooks & Events Overview Apple Notes has no webhook, pub/sub, or event streaming API. To detect changes, you must build your own event system using one of three approaches: (1) JXA polling that compares note snapshots at intervals, (2) file system events (FSEvents) on the NoteStore.sqlite database file for near-real-time change detection, or (3) Apple Shortcuts automations that trigger scripts when specific conditions are met. Each approach has different latency, reliability, and resource consumption tradeoffs. Prerequisites An approved automation identity with read-only access to the intended account and folders. Durable event storage and deduplication before any downstream side effect. A scoped data policy: event records should use opaque note identifiers or salted hashes, not titles or note bodies. Instructions 1. Use polling as the authoritative signal and regard FSEvents and Shortcuts as hints that trigger a new scoped poll. 2. Persist a cursor or snapshot only after a complete successful poll; retain the prior cursor on failure. 3. Deduplicate events by note identifier, change version, and handler before invoking exports, notifications, or other mutations. 4. Debounce file-system activity and never read, modify, or write Apple Notes' private SQLite files directly. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-webhooks-events