imsg

Automate reading and sending iMessages and SMS via macOS Messages.app.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/RJB07/RX01 --skill imsg-rjb07
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/RJB07/RX01/tree/main/core/skills/imsg
Command: npx skills add https://github.com/RJB07/RX01 --skill imsg-rjb07

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates access to iMessage and SMS from the command line, enabling reading chats, viewing history, and sending messages through the macOS Messages.app.

Core Features & Use Cases

  • List chats with metadata and limits
  • View conversation history and attachments info
  • Watch for new messages in real time
  • Send messages to phone numbers or Apple IDs, with optional attachments
  • Respect safety rules by requiring user confirmation before sending

Quick Start

List recent chats and send a message to a contact using imsg.

Frequently Asked Questions about imsg

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

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

To send iMessage or SMS from the command line, you can use a CLI tool to automate the macOS Messages.app, composing texts to phone numbers or Apple IDs directly from the terminal. It requires granting automation permissions and user confirmation before sending.

Can I view iMessage conversation history and chat lists in the terminal?▼

Yes, you can view iMessage conversation history and list recent chats in the terminal by running specific CLI commands that retrieve metadata, attachment info, and past messages from the macOS Messages.app.

What are the requirements to automate macOS Messages.app via CLI?▼

Automating macOS Messages.app via CLI requires a macOS system with active Messages.app access, granted automation permissions, and a supported command-line tool installed to interface with the application.

Is it possible to watch for new iMessages in real time from the command line?▼

Yes, it is possible to watch for new iMessages in real time from the command line using the CLI tool's monitoring feature to detect incoming texts as they arrive in the macOS Messages.app.

How can I attach files to SMS or iMessages sent from the terminal?▼

You can attach files to SMS or iMessages sent from the terminal by utilizing the optional attachments parameter in the CLI command, which routes the file through the macOS Messages.app to the recipient.

Does sending iMessage via CLI require manual confirmation?▼

Yes, sending an iMessage via CLI requires manual user confirmation to respect safety rules, ensuring that messages are not dispatched automatically without explicit approval from the operator.