imsg

The imsg skill provides a robust command-line interface for interacting with the native macOS Messages.app. Designed for automation and personal agent workflows, it allows users to programmatically access their iMessage and SMS communication streams. It is an essential tool for users who want to integrate their text-based messaging into a broader AI assistant ecosystem, enabling automated status updates, quick notifications, or simplified history retrieval without opening the GUI application.

• Full support for listing active chats, including filtering and JSON output for easy piping to tools like jq.

• Retrieve comprehensive conversation history by chat ID, with optional attachment metadata support.

• Real-time monitoring capability allows the skill to watch for new incoming messages on specific threads.

• Versatile message sending functionality that supports both phone numbers and Apple IDs, with manual service selection for iMessage or SMS.

• Integrated safety mechanisms, including mandatory user confirmation workflows for sending messages and handling attachments.

• Ensure the terminal environment has been granted Full Disk Access on macOS to allow the tool to read the Messages.app database.

• Required Automation permissions for Messages.app must be enabled to allow the skill to execute send commands effectively.

• This skill is intended for single-user macOS environments; do not use it for bulk messaging, spamming, or group chat management tasks.

• Always verify recipient identifiers and file paths for attachments before trigger commands; the skill is designed to prioritize safety and user verification.

• When building automation workflows, use the --json flag to integrate output into scripts or OpenClaw logic easily.

• Distinguish between iMessage (blue bubble) and SMS (green bubble) services to ensure delivery protocols match recipient capabilities.