| name | iMessage |
| skill_id | imessage |
| description | Read or send Messages.app conversations on macOS through CLI or AppleScript with explicit confirmation before outbound sends. |
| version | 1.0.0 |
| source_kind | elephant-builtin |
iMessage
Use this skill when the user wants Apple Messages, SMS, or iMessage rather than email or another chat tool.
Preferred Flow
- If the user only wants Messages opened, use
open -a Messages.
- Prefer the
imsg CLI when available: brew install steipete/tap/imsg.
- Use read-only commands first for chat lookup or history.
- Before sending, confirm the recipient, message text, and any attachment path.
- If CLI automation is unavailable, fall back to AppleScript only for narrow, explicit actions.
Guardrails
- Never send to an ambiguous contact.
- Never send bulk or repeated outbound messages without clear approval.
- Report Full Disk Access or Automation permission errors directly.