# Apple Notes Upgrade Migration

> Migrate Apple Notes automation scripts between macOS versions. Trigger: "apple notes upgrade migration".

- Skill: `jeremylongshore/apple-notes-upgrade-migration` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jeremylongshore/apple-notes-upgrade-migration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jeremylongshore/apple-notes-upgrade-migration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: jeremylongshore (https://skillmd.com/u/jeremylongshore)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/jeremylongshore/apple-notes-upgrade-migration

---


# Apple Notes Upgrade & Migration

## macOS Version Changes
| macOS Version | Notes Changes | Migration Impact |
|--------------|---------------|-----------------|
| Ventura (13) | Shared notes via iCloud | New sharing API |
| Sonoma (14) | Tags, smart folders | New JXA properties |
| Sequoia (15) | Math in notes, recording | New content types |

## Migration Steps
```bash
# 1. Export all notes before OS upgrade
osascript -l JavaScript -e "
  const Notes = Application(\"Notes\");
  JSON.stringify(Notes.defaultAccount.notes().map(n => ({
    title: n.name(), body: n.body(), folder: n.container().name()
  })));
" > pre-upgrade-backup.json

# 2. Verify after upgrade
osascript -l JavaScript -e "Application(\"Notes\").defaultAccount.notes.length"

# 3. Test all automation scripts
./scripts/notes-cli.sh count
./scripts/notes-cli.sh list
```

## Resources

- [Mac Automation Scripting Guide](https://developer.apple.com/library/archive/documentation/LanguagesUtilities/Conceptual/MacAutomationScriptingGuide/)
- [JXA Examples](https://jxa-examples.akjems.com/)