imsg

Read, watch, and send iMessage/SMS chats from the macOS terminal.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically interface with Messages.app to read chats, view history, watch conversations, and send iMessages/SMS from a terminal, reducing context switching and boosting productivity.

Core Features & Use Cases

  • Read chats and history from Messages.app
  • Send iMessages/SMS from the terminal with optional attachments
  • Watch ongoing conversations and respond quickly
  • Automate lightweight messaging workflows within scripts

Quick Start

Install imsg on macOS and run a sample command to list chats.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessages from the command line on macOS?

You can send iMessages from the command line by installing the imsg binary via Homebrew on macOS and granting Messages.app automation permissions to execute terminal scripts that send SMS and iMessage texts.

Can I read and monitor iMessage chat history using a CLI tool?

Yes, you can read chat history and monitor ongoing iMessage conversations using a CLI tool by utilizing the imsg binary, which interfaces directly with Messages.app to list chats and watch conversations in real time.

What do I need to automate macOS messaging workflows in terminal scripts?

To automate macOS messaging workflows in terminal scripts, you need the imsg binary installed via Homebrew and must explicitly grant Messages.app automation permissions to allow command-line access for reading and sending texts.

Does sending SMS and iMessage attachments via terminal require special permissions?

Yes, sending SMS and iMessage attachments via terminal requires granting Messages.app automation permissions on macOS to authorize the imsg binary to interface with your chats and dispatch messages programmatically.

What is the best way to integrate iMessage actions into shell scripts?

The best way to integrate iMessage actions into shell scripts is using the imsg command-line binary to read chats, watch conversations, and send messages with optional attachments directly from your macOS terminal environment.

Are there limitations when using a CLI to watch ongoing Messages.app conversations?

A key limitation when using a CLI to watch ongoing Messages.app conversations is strict platform dependency; the imsg binary requires macOS and explicit automation permissions, preventing cross-platform or headless server deployments.