imsg — iMessage/SMS CLI

What it does

The imsg skill enables an agent to interact with macOS Messages.app via the imsg command-line tool: listing chats, viewing conversation history (with optional attachments), watching for new messages, and sending iMessage or SMS to phone numbers or Apple IDs. It includes usage examples and safety checks for confirming recipients and content.

When to use it

Use this skill when a user asks the agent to send an iMessage or SMS, to inspect recent Messages.app chats, or to fetch message history. Not appropriate for Telegram, Signal, WhatsApp, or bulk messaging—those channels use other skills. Requires a macOS host with Messages.app signed in and automation permissions.

What's included

• Scripts: none embedded in the SKILL.md (has_scripts=false)
• References: none listed (has_references=false)
• Instructions: CLI examples for listing chats, viewing history, watching a chat, and sending messages (text or with attachments). Service options (imessage/sms/auto) and safety rules (confirm recipients, avoid unknown numbers, rate limiting) are documented.

Compatible agents

Agents that can run commands on a macOS host with terminal automation and have access to Messages.app (local macOS automation agents, personal assistant agents with macOS integration).