Agent skill · software engineering · jeremylongshore
apple-notes-reference-architecture
Reference architecture for Apple Notes automation systems.
Why this skill is useful
Adds specific JXA scripts and a structured architecture for Apple Notes automation that the AI wouldn't reliably generate on its own.
What it needs
Requires node 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 Reference Architecture Overview Apple Notes automation systems are fundamentally different from cloud SaaS integrations. There is no REST API, no server-side SDK, and no webhook infrastructure. Everything runs locally on macOS through the Apple Events IPC bridge. This reference architecture defines the standard layered approach: a Node.js application layer that calls JXA scripts via osascript, a local SQLite cache for fast queries, a change detection poller for event-driven workflows, and optional Shortcuts integration for cross-app automation. Prerequisites An owned interactive macOS host, exact client TCC consent, and a declared account/folder scope. A reviewed local-only service boundary, encrypted data stores, and an incident/rollback owner. Mocked tests for all application logic; device integration tests run only on a protected self-hosted Mac. Instructions 1. Place authorization, input validation, idempotency, and audit logging above the JXA adapter; the adapter should receive only validated scoped commands. 2. Bind any local service to loopback by default and require an authenticated, approved transport for remote administration. 3. Treat cache and event data as sensitive replicas: minimize fields, encrypt at rest, restrict access, rotate/delete under policy, and never read NoteStore directly. 4. Separate liveness from readiness; pause mutations when authorization, reconciliation, or sync health is uncertain. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-reference-architecture