imsg

List and send iMessage and SMS conversations from macOS Messages.app.

5|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/kcns008/clusterclaw --skill imsg-kcns008
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/kcns008/clusterclaw/tree/main/skills/imsg
Command: npx skills add https://github.com/kcns008/clusterclaw --skill imsg-kcns008

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of checking, monitoring, and sending iMessage or SMS conversations from the command line on macOS, making messaging workflows faster and more automatable.

Core Features & Use Cases

  • Chat Discovery: List recent chats and identify the conversation you need to inspect.
  • Message History Review: Pull threaded history, including attachments, for debugging, support, or personal organization.
  • Live Monitoring and Sending: Watch a chat for new activity or send a message and file directly from Messages.app.
  • Use Case: A support operator can quickly inspect a customer thread, confirm the latest context, and send a follow-up without leaving the terminal.

Quick Start

Use imsg to list your recent chats or send a message from Messages.app on macOS.

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 macOS terminal?

You can send iMessage or SMS from the macOS terminal using the imsg binary to deliver outbound messages directly through Messages.app, enabling fast terminal-based messaging workflows.

Can I list and review iMessage chat history from the command line?

Yes, you can list recent chats and pull threaded message history from the command line. The imsg binary retrieves conversation data and attachment metadata for debugging or support workflows.

What macOS permissions do I need to manage Messages.app from the terminal?

Managing Messages.app from the terminal requires Full Disk Access, macOS automation permissions, and the imsg binary for authenticated retrieval and delivery of iMessage and SMS conversations.

Does imsg work for monitoring live SMS and iMessage conversations?

Yes, imsg supports attachment-aware live monitoring of SMS and iMessage chats, allowing you to watch a conversation for new activity directly within your terminal workflow.

What's the best way to automate customer support replies via iMessage?

Automating customer support replies via iMessage is best handled by using terminal automation to pull chat history, confirm context, and send outbound messages through the imsg binary without leaving the command line.

Why is my terminal unable to access iMessage chat history on macOS?

Terminal access to iMessage chat history fails if macOS automation permissions or Full Disk Access are not granted, as the imsg binary requires both to authenticate retrieval from Messages.app.