| name | apple-apps |
| description | Control Apple apps on this Mac (Calendar events, Reminders app items, Notes, Contacts, Mail), macOS system settings (dark mode, volume, Wi-Fi, app launch, Finder, sleep/lock), and Spotlight file search via AppleScript and shell commands. Use when the action must land in the user's real macOS apps — an appointment in their calendar, a checkbox in their Reminders list, a note, a system toggle. For nagobot's own scheduled jobs, use manage-cron instead. Loads as a router — read the relevant reference file for the task at hand instead of pulling everything into context. |
Apple Apps & macOS
Most commands use osascript (AppleScript) or shell utilities. First run per app may trigger a permission dialog — the user must click Allow. Some operations also require Accessibility permission in System Settings > Privacy & Security > Accessibility.
Date strings are locale-sensitive. If date creation fails, check locale:
exec: defaults read NSGlobalDomain AppleLocale
iCloud-synced data is accessible if signed in. All apps are default macOS apps; no installation needed.
Pick the right reference file
Read only the file for the task at hand — do NOT read all of them.
| Task | Reference file |
|---|
| Calendar (events, scheduling, meetings) | {{SKILLDIR}}/calendar.md |
| Reminders (todos, lists, due dates) | {{SKILLDIR}}/reminders.md |
| Notes (free-form text, folders, search) | {{SKILLDIR}}/notes.md |
| Contacts (phone book, search, create) | {{SKILLDIR}}/contacts.md |
| Mail (inbox search, drafts, unread count) | {{SKILLDIR}}/mail.md |
| macOS system (dark mode, volume, Wi-Fi, Bluetooth, app launch/quit, Finder, sleep/lock, keyboard) | {{SKILLDIR}}/system.md |
Spotlight file search (mdfind, mdls, metadata queries) | {{SKILLDIR}}/spotlight.md |
Workspace root (substituted, used by mail.md for the mail.py helper script): {{WORKSPACE}}.
