imsg

The skill wraps the imsg command-line tool, which interfaces directly with the local Messages.app database and macOS automation APIs. When your agent needs to interact with messages, it:Queries the Messages.app chat database to list conversations or fetch history using commands like imsg chats and imsg history.Optionally watches a specific chat for new incoming messages in real time with imsg watch.Composes and sends messages via imsg send, supporting plain text, file attachments, and explicit service selection (imessage, sms, or auto).Always confirms recipient and message content with the user before dispatching any outbound message, following built-in safety rules.

List Recent Chats — Retrieve your latest conversations with display names, contact info, and chat IDs in JSON format for easy parsing.Conversation History — Read message history for any chat by ID, with optional attachment metadata included.Real-Time Message Watching — Monitor a specific chat for new incoming messages, including attachments.Send iMessage or SMS — Send text messages to phone numbers or Apple IDs, with optional file attachments and explicit service selection (iMessage, SMS, or auto).Service Selection — Force iMessage (blue bubble), SMS (green bubble), or let Messages.app decide automatically.Safety Guardrails — Built-in rules require confirmation of recipient and message content before sending, preventing accidental or bulk messaging.

macOS (required) — This skill is macOS-only and relies on Messages.app and the local macOS messages database. Not available on Linux or Windows.Messages.app Sign-In (required) — Messages.app must be configured and signed in with your Apple ID and/or carrier SMS account.Full Disk Access (required) — Your terminal application must be granted Full Disk Access in System Settings → Privacy & Security → Full Disk Access so the imsg tool can read the Messages database.Automation Permission for Messages.app (required for sending) — Your terminal must be allowed to automate Messages.app, granted in System Settings → Privacy & Security → Automation.

Quick Contact Messaging — Tell your agent "Text mom I'll be late" and it will find the contact, confirm the message, and send it on your behalf.Conversation Review — Ask your agent to pull the last 20 messages from a specific chat to catch up on a conversation thread.Message Monitoring — Have your agent watch a chat for new replies while you focus on other tasks, alerting you when a response arrives.Send Files via iMessage — Share a local image, document, or file to a contact through iMessage directly from your agent workflow.