> apple-notes-reference-architecture
Reference architecture for Apple Notes automation systems. Trigger: "apple notes architecture".
curl "https://skillshub.wtf/jeremylongshore/claude-code-plugins-plus-skills/apple-notes-reference-architecture?format=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
> related_skills --same-repo
> fathom-cost-tuning
Optimize Fathom API usage and plan selection. Trigger with phrases like "fathom cost", "fathom pricing", "fathom plan".
> fathom-core-workflow-b
Sync Fathom meeting data to CRM and build automated follow-up workflows. Use when integrating Fathom with Salesforce, HubSpot, or custom CRMs, or creating automated post-meeting email summaries. Trigger with phrases like "fathom crm sync", "fathom salesforce", "fathom follow-up", "fathom post-meeting workflow".
> fathom-core-workflow-a
Build a meeting analytics pipeline with Fathom transcripts and summaries. Use when extracting insights from meetings, building CRM sync, or creating automated meeting follow-up workflows. Trigger with phrases like "fathom analytics", "fathom meeting pipeline", "fathom transcript analysis", "fathom action items sync".
> fathom-common-errors
Diagnose and fix Fathom API errors including auth failures and missing data. Use when API calls fail, transcripts are empty, or webhooks are not firing. Trigger with phrases like "fathom error", "fathom not working", "fathom api failure", "fix fathom".