imessage

Send and read iMessages/SMS from the macOS terminal via imsg.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/Aevonix/colony-ai --skill imessage-aevonix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Aevonix/colony-ai/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Aevonix/colony-ai --skill imessage-aevonix

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading and sending iMessages/SMS from the terminal is cumbersome without a CLI tool.

Core Features & Use Cases

  • Send iMessages or SMS from the command line using imsg
  • Read chat history and view recent conversations
  • Watch for new messages and respond promptly

Quick Start

Install imsg via Homebrew and start sending or reading iMessages from the terminal.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessages from the macOS terminal?

You can send iMessages from the macOS command line by installing the imsg CLI tool via Homebrew. It integrates directly with the Messages.app to securely send text messages from the terminal.

Can I read chat history and view recent iMessage conversations in the CLI?

You can read chat history and view recent iMessage conversations by running the imsg CLI tool on macOS. It accesses the Messages.app database to retrieve and display past conversation logs directly in the terminal.

Does the imsg CLI tool require the Messages.app to monitor new messages on macOS?

Yes, the imsg CLI requires macOS with the native Messages.app installed to watch for new messages. It integrates with the system's Messages.app to monitor incoming messages and enable prompt responses from the terminal.

What is the best way to automate sending SMS from a macOS command line script?

The best way to automate sending SMS from a macOS command line script is using the imsg CLI tool. It supports lightweight automation workflows by sending iMessages or SMS directly through the Messages.app integration.

How do I get started with using imsg to send and read iMessages?

To get started sending and reading iMessages, install the imsg tool via Homebrew on your macOS device. Once installed, you can use the CLI to send messages, inspect chat history, and watch for new messages from the terminal.

Are there limitations to using a CLI tool for iMessage automation on macOS?

A limitation of using a CLI tool for iMessage automation on macOS is that it requires the imsg tool and an active Messages.app setup. It is designed for individual or lightweight messaging workflows rather than large-scale automated messaging.