skills.rest
Polealpha
PolealphaCOMMUNITY
Explore all skills by this author →
GitHub

imsg

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
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill imsg-polealpha
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
kelinfoxykelinfoxy
1

imsg

Read iMessages and send SMS from the macOS command line.

Community
Intermediate
enclawedenclawed
2

imsg

List, review, and send iMessage or SMS conversations from macOS Messages.app.

Community
Intermediate
estebanrfpestebanrfp
1

imsg

List iMessage and SMS conversations, retrieve history, and send messages via Messages.app.

Community
Intermediate
DonZzzillaDonZzzilla

imessage

Send, read, and track iMessage and SMS via the imsg command-line utility on macOS.

Community
Intermediate