imsg

Name: imsg
Availability: InStock
Author: polealpha

List, fetch, monitor, and send iMessage and SMS chats from a macOS terminal.

Updated Mar 21, 2026

Search Tags:#automation #cli #macos #chat history #sms #imessage #message sending

Ready to run

npx skills add https://github.com/Polealpha/XINNIAN_PI --skill imsg-polealpha

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/imsg
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill imsg-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

imsg removes the tedium of manually browsing iMessage/SMS chats and copying messages by giving you a command-line way to list conversations, inspect history, monitor new messages, and send a message from your terminal on macOS.

Core Features & Use Cases

Chat discovery: Enumerate chats as JSON so you can quickly find the correct chatId.
History retrieval: Pull message history with optional attachments for a specific chat.
Live monitoring: Watch a chat stream to react to incoming messages in near real time.
Message sending: Send iMessage or SMS to a recipient with text and optional file attachments.

Quick Start

Run imsg to list your latest chats as JSON so you can pick a chatId for history or watching.

Frequently Asked Questions about imsg

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

FAQPage Schema

How do I list and fetch iMessage chat history from the terminal on macOS?▼

You can list iMessage chats and fetch chat history from the terminal by running a command-line tool that returns chat data as JSON, allowing you to retrieve messages and optional attachments for a specific chatId.

Can I send iMessage or SMS from a command line interface?▼

Yes, you can send iMessage or SMS from a command line interface by automating Messages.app, which allows you to dispatch outbound messages with text and optional file attachments to a recipient.

What permissions do I need to automate iMessage sending and monitoring on macOS?▼

To automate iMessage sending and monitoring on macOS, you need Messages.app to be signed in, Full Disk Access enabled for your terminal, and Automation permission granted to control Messages.app.

Is there a way to watch for new iMessages in real time from a terminal?▼

Yes, you can watch a specific chat stream to react to incoming iMessages in near real time by running a live monitoring command in your macOS terminal.

How do I export iMessage conversations with attachments using a CLI?▼

You can export iMessage conversations with attachments using a CLI tool that retrieves message history for a specific chatId, outputting the chat data as JSON for easy export and review.