[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M78XDQWNEM57WM0Y340PE80D":3,"skill-same:01M78XDQWNEM57WM0Y340PE80D":57},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":6,"ownerHtmlUrl":39,"ownerBlogUrl":40,"ownerDescription":41,"updatedAt":42,"install":43,"resources":56},"01M78XDQWNEM57WM0Y340PE80D","apple-notes-reference-architecture",null,"Reference architecture for Apple Notes automation systems.\nTrigger: \"apple notes architecture\".","jukeyman\u002Fjukeyman-skills","jukeyman","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F142960420?v=4","01M78FR4Y3DHMMCBCC0GXXNB3F","RICK JEFFERSON","01M78FR4Z8RVQRAD31Y5J7V6EB",1,"MIT","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--apple-notes-pack--apple-notes-reference-architecture\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: apple-notes-reference-architecture\ndescription: |\n  Reference architecture for Apple Notes automation systems.\n  Trigger: \"apple notes architecture\".\nallowed-tools: Read, Write, Edit, Bash(osascript:*), Grep\nversion: 1.0.0\nlicense: MIT\nauthor: Jeremy Longshore \u003Cjeremy@intentsolutions.io>\ntags: [saas, macos, apple-notes, automation]\ncompatible-with: claude-code\n---\n\n# Apple Notes Reference Architecture\n\n## Overview\n\nApple 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.\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────┐\n│                    macOS Machine                      │\n│                                                       │\n│  ┌──────────┐   ┌───────────┐   ┌────────────────┐  │\n│  │ Your App │──▶│ osascript  │──▶│   Notes.app    │  │\n│  │ (Node.js)│   │  (JXA)    │   │  (local DB)    │  │\n│  └────┬─────┘   └───────────┘   └───────┬────────┘  │\n│       │                                   │           │\n│  ┌────▼─────┐   ┌───────────┐   ┌───────▼────────┐  │\n│  │ SQLite   │   │ Shortcuts │   │  iCloud Sync   │  │\n│  │ Cache    │   │ Automations│   │ (bird\u002Fcloudd)  │  │\n│  └──────────┘   └───────────┘   └────────────────┘  │\n│       │                                   │           │\n│  ┌────▼─────┐                    ┌────────▼───────┐  │\n│  │ Poller \u002F │                    │  Other Apple   │  │\n│  │ FSEvents │                    │  Devices       │  │\n│  └──────────┘                    └────────────────┘  │\n└─────────────────────────────────────────────────────┘\n```\n\n## Project Structure\n\n```\napple-notes-automation\u002F\n├── src\u002F\n│   ├── notes-client.ts        # JXA wrapper class (osascript calls)\n│   ├── cache.ts               # SQLite cache layer\n│   ├── templates\u002F             # Note templates (HTML fragments)\n│   ├── export\u002F                # Export to MD\u002FJSON\u002FSQLite\u002FCSV\n│   ├── events\u002F                # Change detection via polling\n│   └── server.ts              # Optional: local HTTP API for remote access\n├── scripts\u002F\n│   ├── notes-cli.sh           # CLI wrapper for common operations\n│   ├── health-check.sh        # Monitoring and alerting\n│   ├── export-all.sh          # Full backup export\n│   └── install.sh             # launchd deployment installer\n├── tests\u002F\n│   ├── mocks\u002F                 # Mock JXA client for CI (non-macOS)\n│   └── unit\u002F                  # Unit tests (vitest)\n├── config\u002F\n│   ├── environments.json      # Account\u002Ffolder per environment\n│   └── launchd.plist          # Service definition template\n└── package.json\n```\n\n## Component Design\n\n```typescript\n\u002F\u002F src\u002Fnotes-client.ts — Core abstraction over osascript\nimport { execSync } from \"child_process\";\n\nexport class NotesClient {\n  private account: string;\n\n  constructor(account = \"iCloud\") { this.account = account; }\n\n  private exec(jxa: string): string {\n    return execSync(`osascript -l JavaScript -e '${jxa.replace(\u002F'\u002Fg, \"'\\\\''\")}'`,\n      { encoding: \"utf8\", timeout: 30000 }).trim();\n  }\n\n  count(): number {\n    return parseInt(this.exec(`Application(\"Notes\").accounts().find(a => a.name() === \"${this.account}\").notes.length`));\n  }\n\n  list(): Array\u003C{ id: string; title: string; modified: string }> {\n    return JSON.parse(this.exec(`\n      JSON.stringify(Application(\"Notes\").accounts().find(a => a.name() === \"${this.account}\")\n        .notes().map(n => ({id: n.id(), title: n.name(), modified: n.modificationDate().toISOString()})))\n    `));\n  }\n\n  create(title: string, body: string, folder = \"Notes\"): string {\n    return this.exec(`\n      const Notes = Application(\"Notes\");\n      const acct = Notes.accounts().find(a => a.name() === \"${this.account}\");\n      const f = acct.folders().find(f => f.name() === \"${folder}\") || acct.folders[0];\n      const n = Notes.Note({name: \"${title}\", body: \"${body}\"});\n      f.notes.push(n); n.id();\n    `);\n  }\n}\n```\n\n## Key Constraints\n\n| Constraint | Impact | Workaround |\n|-----------|--------|------------|\n| macOS only | No Linux\u002FWindows servers | Run on Mac; export data for cross-platform consumption |\n| No REST API | Cannot access remotely | Optional: expose local HTTP server; lock down to localhost |\n| iCloud sync lag | Writes may take 5-30s to appear on other devices | Poll with delay; verify on target device |\n| No webhooks | Cannot receive push notifications | Poll for changes every 60s; watch FSEvents on Notes DB |\n| HTML-only body | No native Markdown support | Convert HTML to\u002Ffrom Markdown in export\u002Fimport layer |\n| No attachment export via JXA | Binary data inaccessible from scripting | Use Shortcuts for attachment extraction |\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Architecture requires macOS server | No cloud-native option | Dedicate a Mac mini as automation server; use Tailscale for remote access |\n| Local HTTP API exposed to network | Security risk if not locked down | Bind to 127.0.0.1 only; use SSH tunnel for remote access |\n| Cache out of sync with Notes | Polling interval too long | Reduce poll interval; use FSEvents on NoteStore.sqlite for faster detection |\n| Template HTML rejected by Notes | Invalid HTML tags | Test templates with a canary note before bulk creation |\n\n## Resources\n\n- [Mac Automation Scripting Guide](https:\u002F\u002Fdeveloper.apple.com\u002Flibrary\u002Farchive\u002Fdocumentation\u002FLanguagesUtilities\u002FConceptual\u002FMacAutomationScriptingGuide\u002F)\n- [JXA Cookbook](https:\u002F\u002Fgithub.com\u002FJXA-Cookbook\u002FJXA-Cookbook)\n- [macOS Security Architecture](https:\u002F\u002Fsupport.apple.com\u002Fguide\u002Fsecurity\u002Fwelcome\u002Fweb)\n\n## Next Steps\n\nFor deploying this architecture as a service, see `apple-notes-deploy-integration`. For monitoring the running system, see `apple-notes-observability`.\n","# Apple Notes Reference Architecture\n\n## Overview\n\nApple 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.\n\n## System Architecture\n\n```\n┌─────────────────────────────────────────────────────┐\n│                    macOS Machine                      │\n│                                                       │\n│  ┌──────────┐   ┌───────────┐   ┌────────────────┐  │\n│  │ Your App │──▶│ osascript  │──▶│   Notes.app    │  │\n│  │ (Node.js)│   │  (JXA)    │   │  (local DB)    │  │\n│  └────┬─────┘   └───────────┘   └───────┬────────┘  │\n│       │                                   │           │\n│  ┌────▼─────┐   ┌───────────┐   ┌───────▼────────┐  │\n│  │ SQLite   │   │ Shortcuts │   │  iCloud Sync   │  │\n│  │ Cache    │   │ Automations│   │ (bird\u002Fcloudd)  │  │\n│  └──────────┘   └───────────┘   └────────────────┘  │\n│       │                                   │           │\n│  ┌────▼─────┐                    ┌────────▼───────┐  │\n│  │ Poller \u002F │                    │  Other Apple   │  │\n│  │ FSEvents │                    │  Devices       │  │\n│  └──────────┘                    └────────────────┘  │\n└─────────────────────────────────────────────────────┘\n```\n\n## Project Structure\n\n```\napple-notes-automation\u002F\n├── src\u002F\n│   ├── notes-client.ts        # JXA wrapper class (osascript calls)\n│   ├── cache.ts               # SQLite cache layer\n│   ├── templates\u002F             # Note templates (HTML fragments)\n│   ├── export\u002F                # Export to MD\u002FJSON\u002FSQLite\u002FCSV\n│   ├── events\u002F                # Change detection via polling\n│   └── server.ts              # Optional: local HTTP API for remote access\n├── scripts\u002F\n│   ├── notes-cli.sh           # CLI wrapper for common operations\n│   ├── health-check.sh        # Monitoring and alerting\n│   ├── export-all.sh          # Full backup export\n│   └── install.sh             # launchd deployment installer\n├── tests\u002F\n│   ├── mocks\u002F                 # Mock JXA client for CI (non-macOS)\n│   └── unit\u002F                  # Unit tests (vitest)\n├── config\u002F\n│   ├── environments.json      # Account\u002Ffolder per environment\n│   └── launchd.plist          # Service definition template\n└── package.json\n```\n\n## Component Design\n\n```typescript\n\u002F\u002F src\u002Fnotes-client.ts — Core abstraction over osascript\nimport { execSync } from \"child_process\";\n\nexport class NotesClient {\n  private account: string;\n\n  constructor(account = \"iCloud\") { this.account = account; }\n\n  private exec(jxa: string): string {\n    return execSync(`osascript -l JavaScript -e '${jxa.replace(\u002F'\u002Fg, \"'\\\\''\")}'`,\n      { encoding: \"utf8\", timeout: 30000 }).trim();\n  }\n\n  count(): number {\n    return parseInt(this.exec(`Application(\"Notes\").accounts().find(a => a.name() === \"${this.account}\").notes.length`));\n  }\n\n  list(): Array\u003C{ id: string; title: string; modified: string }> {\n    return JSON.parse(this.exec(`\n      JSON.stringify(Application(\"Notes\").accounts().find(a => a.name() === \"${this.account}\")\n        .notes().map(n => ({id: n.id(), title: n.name(), modified: n.modificationDate().toISOString()})))\n    `));\n  }\n\n  create(title: string, body: string, folder = \"Notes\"): string {\n    return this.exec(`\n      const Notes = Application(\"Notes\");\n      const acct = Notes.accounts().find(a => a.name() === \"${this.account}\");\n      const f = acct.folders().find(f => f.name() === \"${folder}\") || acct.folders[0];\n      const n = Notes.Note({name: \"${title}\", body: \"${body}\"});\n      f.notes.push(n); n.id();\n    `);\n  }\n}\n```\n\n## Key Constraints\n\n| Constraint | Impact | Workaround |\n|-----------|--------|------------|\n| macOS only | No Linux\u002FWindows servers | Run on Mac; export data for cross-platform consumption |\n| No REST API | Cannot access remotely | Optional: expose local HTTP server; lock down to localhost |\n| iCloud sync lag | Writes may take 5-30s to appear on other devices | Poll with delay; verify on target device |\n| No webhooks | Cannot receive push notifications | Poll for changes every 60s; watch FSEvents on Notes DB |\n| HTML-only body | No native Markdown support | Convert HTML to\u002Ffrom Markdown in export\u002Fimport layer |\n| No attachment export via JXA | Binary data inaccessible from scripting | Use Shortcuts for attachment extraction |\n\n## Error Handling\n\n| Issue | Cause | Solution |\n|-------|-------|----------|\n| Architecture requires macOS server | No cloud-native option | Dedicate a Mac mini as automation server; use Tailscale for remote access |\n| Local HTTP API exposed to network | Security risk if not locked down | Bind to 127.0.0.1 only; use SSH tunnel for remote access |\n| Cache out of sync with Notes | Polling interval too long | Reduce poll interval; use FSEvents on NoteStore.sqlite for faster detection |\n| Template HTML rejected by Notes | Invalid HTML tags | Test templates with a canary note before bulk creation |\n\n## Resources\n\n- [Mac Automation Scripting Guide](https:\u002F\u002Fdeveloper.apple.com\u002Flibrary\u002Farchive\u002Fdocumentation\u002FLanguagesUtilities\u002FConceptual\u002FMacAutomationScriptingGuide\u002F)\n- [JXA Cookbook](https:\u002F\u002Fgithub.com\u002FJXA-Cookbook\u002FJXA-Cookbook)\n- [macOS Security Architecture](https:\u002F\u002Fsupport.apple.com\u002Fguide\u002Fsecurity\u002Fwelcome\u002Fweb)\n\n## Next Steps\n\nFor deploying this architecture as a service, see `apple-notes-deploy-integration`. For monitoring the running system, see `apple-notes-observability`.\n",{"name":5,"tags":24,"author":29,"license":15,"version":30,"description":31,"allowed-tools":32,"compatible-with":33},[25,26,27,28],"saas","macos","apple-notes","automation","Jeremy Longshore \u003Cjeremy@intentsolutions.io>","1.0.0","Reference architecture for Apple Notes automation systems.\nTrigger: \"apple notes architecture\".\n","Read, Write, Edit, Bash(osascript:*), Grep","claude-code","main","99825ad3f3bcc6597ddcc7294a14e6e922f2b67b","skills\u002Fsaas-packs--apple-notes-pack--apple-notes-reference-architecture",0,"https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills","https:\u002F\u002Fgithub.com\u002Fjukeyman","https:\u002F\u002FRJBUSINESSSOLUTIONS.ORG","Credit and Finance Expert | Developer\r\n\r\nI'm Rick Jefferson, a seasoned credit and finance expert with over a decade of experience in financial literacy,","2026-07-13 07:03:29",{"source":8,"skillName":5,"commands":44,"prompt":54,"zipAvailable":55},[45,48,51],{"tool":46,"command":47},"npx","npx skills add jukeyman\u002Fjukeyman-skills --skill apple-notes-reference-architecture",{"tool":49,"command":50},"bunx","bunx skills add jukeyman\u002Fjukeyman-skills --skill apple-notes-reference-architecture",{"tool":52,"command":53},"pnpm","pnpm dlx skills add jukeyman\u002Fjukeyman-skills --skill apple-notes-reference-architecture","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fsaas-packs--apple-notes-pack--apple-notes-reference-architecture\u002FSKILL.md",true,[],[58,65,72,79,86,94],{"skillNo":59,"name":60,"nameZh":6,"description":61,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":62,"categories":63,"keywords":64,"publishedAt":19},"01M79ANS2SM329NEP5ZCX106RR","zustand-store-creator","Create zustand store creator operations. Auto-activating skill for Frontend Development.\nTriggers on: zustand store creator, zustand store creator\nPart of the Frontend Development skill category. Use when working with zustand store creator functionality. Trigger with phrases like \"zustand store creator\", \"zustand creator\", \"zustand\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzustand-store-creator\u002FSKILL.md",[],[],{"skillNo":66,"name":67,"nameZh":6,"description":68,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":19},"01M79AMZKP4YDEZ7EHG1Y7PP74","zero-trust-config-helper","Configure with zero trust config helper operations. Auto-activating skill for Security Advanced.\nTriggers on: zero trust config helper, zero trust config helper\nPart of the Security Advanced skill category. Use when configuring systems or services. Trigger with phrases like \"zero trust config helper\", \"zero helper\", \"zero\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzero-trust-config-helper\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":19},"01M79AMJSBCEJQNBTYNAHYN5HM","zapier-integration-helper","Assist with zapier integration helper operations. Auto-activating skill for Business Automation.\nTriggers on: zapier integration helper, zapier integration helper\nPart of the Business Automation skill category. Use when working with APIs or building integrations. Trigger with phrases like \"zapier integration helper\", \"zapier helper\", \"zapier\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzapier-integration-helper\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":19},"01M79AHJZGVMARS13VFQYRR1MP","yaml-config-validator","Validate yaml config validator operations. Auto-activating skill for DevOps Basics.\nTriggers on: yaml config validator, yaml config validator\nPart of the DevOps Basics skill category. Use when configuring systems or services. Trigger with phrases like \"yaml config validator\", \"yaml validator\", \"yaml\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fyaml-config-validator\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":90,"sourceHtmlUrl":91,"categories":92,"keywords":93,"publishedAt":19},"01M79AHGDZRN0020RDQSQDPAM8","xvary-stock-research","Thesis-driven equity analysis from public SEC EDGAR and market data; \u002Fanalyze, \u002Fscore, \u002Fcompare workflows with bundled Python tools (Claude Code, Cursor, Codex).","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxvary-stock-research\u002FSKILL.md",[],[],{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":100,"publishedAt":19},"01M79AHCYJ9FV9RMHQ24HDRN33","xss-vulnerability-scanner","Scan xss vulnerability scanner operations. Auto-activating skill for Security Fundamentals.\nTriggers on: xss vulnerability scanner, xss vulnerability scanner\nPart of the Security Fundamentals skill category. Use when working with xss vulnerability scanner functionality. Trigger with phrases like \"xss vulnerability scanner\", \"xss scanner\", \"xss\".","https:\u002F\u002Fgithub.com\u002Fjukeyman\u002Fjukeyman-skills\u002Fblob\u002Fmain\u002Fskills\u002Fxss-vulnerability-scanner\u002FSKILL.md",[],[]]