apple-macos-workflows

Apple/macOS Workflows

Use this umbrella when a task involves native Apple apps, macOS-only CLIs, cross-device Apple data, or GUI automation on the user's Mac.

Choose the surface first

User intent	Tooling pattern
Create/search/edit Apple Notes	Use memo against Notes.app; prefer memory only for agent-internal facts.
Add/list/complete reminders	Use remindctl; prefer Reminders for user-visible tasks and due dates.
Send/read iMessage or SMS	Use imsg; verify recipient/chat before sending.
Locate Apple devices/AirTags	Use the FindMy app/CLI pattern; treat locations as sensitive.
Drive arbitrary native apps	Use background computer_use capture/click/type workflow; verify after state changes.

Apple Notes via memo

Prereqs: macOS Notes.app, brew tap antoniorodr/memo && brew install antoniorodr/memo/memo, Automation permission to Notes.

Common commands:

memo notes
memo notes -s "query"
memo notes -a "Title"
memo notes -e
memo notes -ex

Rules: use Notes for cross-device synced user notes; use Obsidian for Markdown-native vault work; do not use Notes for agent memory.

Apple Reminders via remindctl

Prereqs: macOS Reminders.app and remindctl installed/configured. Use for visible to-dos, due dates, and task lists. Confirm destructive completion/deletion when ambiguous.

iMessage/SMS via imsg

Use when the user asks to message a person through Apple Messages. Search or list chats first when the target is ambiguous. Never send secrets, 2FA codes, payment details, or sensitive content without explicit user text and target verification.

Find My

Use only for user-requested device/person/item location checks. Treat location output as private. Return concise status and timestamp; do not background-track unless explicitly requested.

Background macOS computer use

Canonical loop:

1. Capture the target app with numbered elements.
2. Click/type by element index, not coordinates, when possible.
3. Re-capture after every state-changing action.

Rules: do not raise windows unless asked; scope captures to the relevant app; never interact with permission dialogs, passwords, payment UI, or 2FA prompts without explicit approval.

Safety checklist

• Verify the app/account/context before modifying user-visible data.
• Prefer CLI/API tools over GUI driving when available.
• Ask before destructive changes or messages to external people.
• Keep screenshots and locations out of summaries unless needed.