Agent skill · software engineering · jeremylongshore
apple-notes-performance-tuning
Optimize Apple Notes automation performance for large note collections.
Why this skill is useful
Adds executable scripts for optimizing Apple Notes automation performance that aren't in public documentation.
What it needs
Requires jq, sqlite3 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 Performance Tuning Overview Apple Notes automation performance degrades linearly with note count because JXA loads all note objects into memory when you access a collection. A vault with 10,000+ notes can take 30+ seconds for a simple list operation. The primary bottleneck is the Apple Events bridge between your script and Notes.app — every property access (name, body, date) is a separate IPC call. This guide covers caching strategies, incremental sync, batch optimization, and architectural patterns to keep automation responsive at scale. Prerequisites A scoped workload baseline, performance budget, and a non-production corpus for tests. A private encrypted cache with retention, redaction, and explicit access controls; a cache is a duplicate of sensitive notes. A feature flag and rollback plan for polling interval, cache, or batching changes. Instructions 1. Measure a bounded read-only workload before changing timeouts, concurrency, or poll intervals. 2. Minimize fields and property calls; never cache a body when an opaque identifier or timestamp is sufficient. 3. Keep cache updates idempotent, encrypted, and scoped; reconcile change cursors before writing a new cursor. 4. Roll back a tuning change if latency, sync behavior, or data-reconciliation evidence regresses. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-performance-tuning