Agent skill

apple-notes-reference-architecture

Reference architecture for Apple Notes automation systems. Trigger: "apple notes architecture".

Stars 1,803
Forks 241

Install this agent skill to your Project

npx add-skill https://github.com/jeremylongshore/claude-code-plugins-plus-skills/tree/main/plugins/saas-packs/apple-notes-pack/skills/apple-notes-reference-architecture

SKILL.md

Apple Notes Reference Architecture

Architecture

┌────────────────────────────────────────────────┐
│                macOS Machine                     │
│                                                  │
│  ┌──────────┐   ┌───────────┐   ┌────────────┐ │
│  │ Your App │──▶│ osascript  │──▶│ Notes.app  │ │
│  │ (Node.js)│   │ (JXA/AS)  │   │ (iCloud)   │ │
│  └──────────┘   └───────────┘   └────────────┘ │
│       │                               │          │
│  ┌────▼─────┐                  ┌──────▼───────┐ │
│  │ SQLite   │                  │ iCloud Sync  │ │
│  │ Cache    │                  │ (automatic)  │ │
│  └──────────┘                  └──────────────┘ │
└────────────────────────────────────────────────┘

Project Structure

apple-notes-automation/
├── src/
│   ├── notes-client.ts       # JXA wrapper class
│   ├── templates/             # Note templates
│   ├── export/                # Export to MD/JSON/SQLite
│   ├── events/                # Change detection polling
│   └── server.ts              # Optional: local API server
├── scripts/
│   ├── notes-cli.sh           # CLI wrapper
│   ├── export-all.sh          # Full export script
│   └── template-create.js     # JXA template engine
├── tests/
│   ├── mocks/                 # Mock client for CI
│   └── unit/                  # Unit tests
└── package.json

Key Constraints

Constraint Impact Workaround
macOS only No Linux/Windows Run on Mac; export for cross-platform
No REST API Cannot access remotely Local-only; export to portable format
iCloud sync lag Writes may not appear instantly Poll with delay
No webhooks Cannot push events Poll for changes
HTML-only body No native Markdown Convert on export

Resources

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results