imsg

Send and read iMessage and SMS messages on macOS via the imsg CLI.

1|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill imsg-solizardking
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Solizardking/Solana-Robotics-Kit/tree/main/eliza/packages/skills/skills/imsg
Command: npx skills add https://github.com/Solizardking/Solana-Robotics-Kit --skill imsg-solizardking

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reading and sending iMessage or SMS conversations normally requires the Messages app GUI, making it impossible to script or automate texting workflows from the terminal on macOS. ## Core Features & Use Cases - List and inspect chats: Run imsg chats --limit 10 --json to enumerate recent conversations and obtain chat IDs. - Fetch history and watch live: Use imsg history to read past messages with attachments, or imsg watch to stream incoming messages in real time. - Send messages with attachments: Use imsg send --to <phone-or-email> --text ... --file ... with --service imessage|sms|auto to control delivery. - Use Case: An AI agent monitors a high-signal chat with imsg watch and automatically replies to incoming texts after confirming the recipient and message content. ## Quick Start Ask the assistant to list your recent iMessage chats and send a text saying hello to a specific phone number using the imsg CLI.

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 from the terminal on macOS?

Use the imsg CLI: run `imsg send --to "+14155551212" --text "hi"` to send a message to a phone number or email. You can attach files with `--file /path/pic.jpg` and choose delivery with `--service imessage|sms|auto`.

How do I read iMessage history from the command line?

First run `imsg chats --limit 10 --json` to find the chat ID, then run `imsg history --chat-id <id> --limit 20 --attachments --json` to fetch recent messages with attachment metadata in JSON format.

What permissions does imsg need on macOS?

imsg requires Messages.app to be signed in, Full Disk Access granted to your terminal, and Automation permission to control Messages.app for sending. It only works on macOS (darwin).

How do I install the imsg CLI?

Install it via Homebrew with the steipete tap: `brew install steipete/tap/imsg`. This provides the `imsg` binary used for all chat, history, watch, and send commands.

Can imsg stream incoming messages in real time?

Yes, run `imsg watch --chat-id <id> --attachments` to stream incoming messages for a specific conversation as they arrive, which is useful for building auto-reply or monitoring workflows.