imsg

Manage iMessage and SMS chats from the macOS command line.

Updated Feb 3, 2026
One-click install
npx skills add https://github.com/Dolonia333/dolo.ai --skill imsg-dolonia333
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Dolonia333/dolo.ai/tree/main/skills/imsg
Command: npx skills add https://github.com/Dolonia333/dolo.ai --skill imsg-dolonia333

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates access to Messages.app iMessage and SMS from the command line, reducing context switching and manual tapping.

Core Features & Use Cases

  • List chats and threads from Messages.app.
  • Retrieve chat history and attachments for a given chat.
  • Send iMessage or SMS from the terminal.
  • Watch for new messages in real-time.

Quick Start

Run imsg to read chats, view history, watch for new messages, and send messages from the terminal.

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 macOS command line?

You can send an iMessage from the macOS command line by running the imsg tool, which interfaces with Messages.app to automate sending texts directly from the terminal.

Can I retrieve chat history and attachments from Messages.app using a CLI script?

Yes, retrieving chat history and attachments from Messages.app is possible using CLI scripting, as the imsg tool lists threads and extracts conversation data for auditing purposes.

Do I need any special permissions to automate iMessage on macOS?

Automating iMessage on macOS requires appropriate automation permissions granted to the CLI tool, alongside a macOS environment with the native Messages.app installed and properly configured.

What is the best way to watch for new iMessages in real-time for scripting automation?

The best way to watch for new iMessages in real-time for scripting automation is using the imsg tool's watch feature, which monitors Messages.app activity continuously from the terminal.

Are there limitations when controlling SMS and iMessage from the macOS terminal?

Limitations when controlling SMS and iMessage from the macOS terminal include strict dependency on the Messages.app environment and the necessity of maintaining valid macOS automation permissions.