apple-notes-performance-tuning
Installation
SKILL.md
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
- Measure a bounded read-only workload before changing timeouts, concurrency, or poll intervals.
- Minimize fields and property calls; never cache a body when an opaque identifier or timestamp is sufficient.
- Keep cache updates idempotent, encrypted, and scoped; reconcile change cursors before writing a new cursor.
- Roll back a tuning change if latency, sync behavior, or data-reconciliation evidence regresses.