Apple platform automation

Apple Platform Automation

Use this umbrella for Apple/macOS personal-productivity and device tasks. Prefer native or purpose-built CLIs first; fall back to AppleScript/GUI automation only when no CLI exists.

Prerequisite checks

1. Confirm the task is running on macOS before promising Apple app access.
2. Check the specific CLI exists (memo, remindctl, imsg) before using it.
3. For GUI workflows, prefer Peekaboo or screenshot-assisted automation and verify the visible state before acting.
4. For outbound messages or destructive edits, confirm the recipient/item and exact action with the user.

Apple Notes (memo)

Use for creating, searching, viewing, moving, exporting, editing, or deleting Apple Notes. Typical flow:

memo list
memo search "query"
memo create --title "Title" --body "Body"
memo edit <note-id>

Rules: do not use Apple Notes as the default knowledge base if the user asked for Obsidian/Notion/Google Docs; verify note IDs before edits or deletes.

Apple Reminders (remindctl)

Use for listing reminder lists, adding dated reminders, completing items, or deleting stale tasks.

remindctl lists
remindctl list --list "Inbox"
remindctl add "Task text" --due "tomorrow 9am" --list "Inbox"
remindctl complete <reminder-id>

Natural due dates are usually accepted, but verify parsed dates when timing matters.

Find My / AirTags / Apple devices

Use FindMy.app when the user asks for Apple device or AirTag locations. There is no reliable universal CLI; use one of:

• AppleScript to open Find My and switch tabs.
• Peekaboo/screenshot capture to inspect device or item location.
• Repeated captures for tracking over time while the item detail remains open.

Limitations: location may be stale, approximate, hidden behind privacy prompts, or unavailable until the app has focus. Report uncertainty explicitly.

iMessage / SMS (imsg)

Use for listing chats, reading history, sending text or attachments, and watching for new messages.

imsg chats
imsg history <chat-id> --limit 20
imsg send <chat-id> "message text"
imsg send <chat-id> --attachment /path/to/file "caption"

Safety: before sending, confirm the resolved chat/contact and message body unless the user has already specified an unambiguous target and content in the same request.

Common pitfalls

• Apple automation is macOS-only; fail fast on Linux/remote containers.
• GUI state is not proof of completion; capture or query after acting.
• Contact names can match multiple chats; disambiguate before sending.
• Do not claim precise Find My coordinates unless the app or tool actually exposes them.