imsg

Manage iMessage and SMS chats, history, and sending via command line.

19|3|Updated Mar 7, 2026
One-click install
npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill imsg-samttoo22-mewcat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/samttoo22-MewCat/OpenSoul/tree/main/openclaw/skills/imsg
Command: npx skills add https://github.com/samttoo22-MewCat/OpenSoul --skill imsg-samttoo22-mewcat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to interact with your iMessage and SMS conversations directly from the command line, enabling you to list chats, view message history, and send new messages.

Core Features & Use Cases

  • List Chats: View a list of your recent iMessage/SMS conversations.
  • View History: Retrieve past messages within a specific chat, with options for attachments.
  • Send Messages: Compose and send text messages or messages with attachments via iMessage or SMS.
  • Use Case: You need to quickly send a text message to a contact without opening the Messages app on your Mac.

Quick Start

Use the imsg skill to send the text "Hello!" to the phone number +14155551212.

Frequently Asked Questions about imsg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send an iMessage or SMS from the command line on macOS?

You can send iMessage or SMS from the command line by using this tool to interact with macOS Messages.app. It allows you to compose and send text messages or attachments by specifying a target phone number and the desired service, such as iMessage or SMS.

Can I retrieve iMessage chat history and attachments via the terminal?

Yes, you can retrieve iMessage chat history and attachments via the terminal. This tool interfaces with macOS Messages.app to list recent chats and extract past messages within a specific conversation, including detailed attachment information.

Do I need macOS Messages.app signed in to manage SMS and iMessage from the CLI?

Yes, you need macOS Messages.app signed in to manage SMS and iMessage from the CLI. The tool requires an active Messages.app session and appropriate terminal permissions to access your conversations and send messages successfully.

What is the best way to automate sending text messages without opening the Messages app?

The best way to automate sending text messages without opening the Messages app is using a CLI tool that interfaces directly with macOS Messages.app. It enables programmatic message composition and sending via iMessage or SMS services.

Does this CLI messaging tool support choosing between iMessage and SMS for delivery?

Yes, this CLI messaging tool supports choosing between iMessage and SMS for delivery. When sending a message, you can explicitly specify the service as iMessage, SMS, or auto, allowing control over how the message is routed through macOS Messages.app.