imsg

Automate iMessage and SMS interactions from the macOS terminal.

Updated Feb 16, 2026

Search Tags:#automation #messaging #cli #macos #history #imessage #send

Ready to run

npx skills add https://github.com/RobbyMo81/assistantrobby --skill imsg-robbymo81

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/RobbyMo81/assistantrobby/tree/main/skills/imsg
Command: npx skills add https://github.com/RobbyMo81/assistantrobby --skill imsg-robbymo81

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS management and automation from the CLI to streamline messaging workflows on macOS.

Core Features & Use Cases

List chats and fetch chat history from Messages.app to keep conversations organized.
Watch a chat in real time to monitor new messages and respond quickly.
Send messages programmatically to contact numbers or addresses.

Quick Start

Run imsg chats --limit 10 --json to list your chats.

Frequently Asked Questions about imsg

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

FAQPage Schema

How do I send iMessage from the terminal?▼

You can send iMessage from the terminal by executing the send subcommand with a contact number or address, which programmatically dispatches the message through Messages.app on macOS.

Can I view iMessage chat history in the command line?▼

Yes, you can view iMessage chat history in the command line by running the history subcommand to fetch and display past conversation logs directly from Messages.app.

Does iMessage terminal automation require macOS Messages.app permissions?▼

Yes, iMessage terminal automation requires macOS Messages.app to be signed in and explicitly permitted for local automation to execute commands like chats, history, watch, and send.

What is the best way to monitor an active SMS chat in real time?▼

The best way to monitor an active SMS chat in real time is using the watch subcommand, which listens to Messages.app and streams new messages directly to your terminal interface.

How do I list my recent iMessage conversations using a CLI?▼

You can list recent iMessage conversations using a CLI by running the chats subcommand, which retrieves and organizes your active Messages.app chats into a terminal-readable format.