imsg

Send iMessage and SMS messages with attachments via command line.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/JiayueMeng128/OpenClaw2Androidtrying --skill imsg-jiayuemeng128
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/JiayueMeng128/OpenClaw2Androidtrying/tree/main/openclaw/skills/imsg
Command: npx skills add https://github.com/JiayueMeng128/OpenClaw2Androidtrying --skill imsg-jiayuemeng128

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and 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 send and receive messages without needing to open the Messages.app.

Core Features & Use Cases

  • Send iMessages/SMS: Compose and send text messages or messages with attachments to contacts.
  • List Chats: View a list of your recent iMessage/SMS conversations.
  • View History: Retrieve message history for specific chats.
  • Watch for New Messages: Monitor a chat for incoming messages in real-time.
  • Use Case: Quickly send a text to a contact letting them know you're running late, or retrieve the last few messages from a specific chat to catch up.

Quick Start

Send a message to +14155551212 with the text "Hello!"

Frequently Asked Questions about imsg

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

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

You can send iMessages or SMS from the macOS command line by executing the imsg binary with a recipient's phone number and your text content. This Skill facilitates sending messages with text and attachments directly without opening the Messages app.

Can I retrieve iMessage chat history using a CLI tool?

Yes, you can retrieve iMessage chat history using this CLI tool by listing recent conversations and viewing specific chat histories. It integrates with macOS Messages.app to fetch and display your past message exchanges directly in the terminal.

Does sending SMS via the macOS command line require the Messages app?

Yes, sending SMS via the macOS command line requires the Messages.app integration for operation. The Skill acts as a command-line interface that communicates through the native macOS messaging infrastructure and the imsg binary.

How do I monitor incoming iMessages in real time via the terminal?

To monitor incoming iMessages in real time via the terminal, use the watch feature to monitor a chat for new incoming messages. This allows you to track live SMS and iMessage conversations without keeping the Messages application open.

What is the best way to automate sending SMS attachments on macOS?

The best way to automate sending SMS attachments on macOS is using a CLI Skill that facilitates sending messages with attachments. By executing commands through the imsg binary, you can programmatically attach files to your outgoing communications.

Can I list recent iMessage conversations without opening the Messages app?

Yes, you can list recent iMessage conversations without opening the Messages app by using the list chats feature. This Skill manages iMessage communication via a command-line interface to view your recent chat histories directly on macOS.