imsg

• You want your agent to send an iMessage or SMS on your behalf to a contact's phone number or Apple ID.
• You need to read recent chat history or browse your Messages.app conversations programmatically.
• You want to watch a specific chat for new incoming messages in real time.
• You are sending to a contact already in your Messages.app on a Mac where you are signed in to iCloud.

• You want to message on Telegram, Signal, WhatsApp, Discord, or Slack — use the appropriate channel or skill for those platforms instead.
• You need to manage group chats (adding or removing members) — this is not supported by imsg.
• You are on Windows or Linux — imsg requires macOS with Messages.app.
• You want to do bulk or mass messaging — always get explicit user confirmation per message.

Retrieve a paginated, JSON-formatted list of your most recent Messages.app conversations. Useful for finding a contact's chat ID before reading history or sending a message.

Fetch message history for any chat by ID, with a configurable limit. Optionally include attachment metadata so your agent knows what files were shared.

Send text messages (and file attachments) to any phone number or Apple ID. Explicitly force --service imessage or --service sms, or let Messages.app decide automatically.

Stream new messages from a specific chat in real time using imsg watch, including attachment info — ideal for building responsive messaging workflows.

Send local files alongside text messages using --file /path/to/file. History queries can also surface attachment metadata so your agent can reference previously shared files.

The skill's guidance enforces confirmation of recipient and message content before sending, avoids messaging unknown numbers without approval, and discourages rate-limit-violating bulk sends.

Ask your agent to "text Mom I'll be late." It searches your chats for Mom's contact, confirms the number and message text with you, then sends via iMessage or SMS — all without opening the Messages app manually.

Pull the last 20 messages from a specific chat to give your agent context about an ongoing conversation before drafting a reply or summary.

Share a local image or document with a contact by providing a file path — the skill attaches it to the outgoing message automatically.

Use imsg watch on a specific chat ID so your agent can react to incoming messages in real time, enabling lightweight conversational automation over iMessage.