Agent skill · software engineering · jeremylongshore
apple-notes-local-dev-loop
Set up local development workflow for Apple Notes automation with JXA
Why this skill is useful
Adds executable scripts for hot-reloading JXA automation in Apple Notes, which are not available in public documentation.
What it needs
Requires chokidar, npm, tsx, typescript installed locally. About 2k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Apple Notes Local Dev Loop Overview Iterative development workflow for Apple Notes JXA scripts with file watching and test helpers. Prerequisites A local macOS development machine and a test-only On My Mac folder, or a fully mocked Notes adapter. Synthetic test fixtures with no production note content, account names, or credentials. A source-controlled allowlist of scripts eligible for local execution. Instructions Step 1: Project Setup Step 2: JXA Runner with Hot Reload Step 3: Test Helper Step 4: Dev Scripts Output Hot-reload JXA development with file watching Test helpers for note CRUD operations Iterative script development workflow Error Handling Stop the watcher when a script fails and surface only the exit status plus a redacted error category. Never hot-run an edited script against a production or synchronized default account. If a test mutation is required, use the designated test folder and reconcile it before the next run. Examples Run unit tests against a mock client while editing. When a JXA smoke test is necessary, point it at the designated local test folder with a synthetic title, verify the resulting opaque identifier, and clean it up under a test fixture lifecycle—do not run the watcher against defaultAccount. Resources Mac Automation Scripting Guide JXA Examples
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/apple-notes-local-dev-loop