imessage

Read and send iMessages and SMS via the imsg CLI on macOS.

2.8k|332|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/moltis-org/moltis --skill imessage-moltis-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/moltis-org/moltis/tree/main/crates/skills/src/assets/apple/imessage
Command: npx skills add https://github.com/moltis-org/moltis --skill imessage-moltis-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and write iMessages and SMS from the terminal on macOS using the imsg CLI, removing the need to switch to Messages.app for every interaction.

Core Features & Use Cases

  • Read chats history and list chats with simple imsg commands.
  • Send messages to contacts or phone numbers from the command line.
  • Monitor for new messages and integrate with automated workflows in macOS.
  • Requires macOS with Messages.app signed in and the imsg binary installed via Homebrew.

Quick Start

Install imsg using Homebrew and begin issuing imsg commands to read or send messages.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessage or SMS from the command line on macOS?

You can send iMessage or SMS from the macOS command line by using the imsg CLI. It interfaces directly with Messages.app to send texts to contacts or phone numbers without opening the application.

Can I read iMessage chat history through the terminal?

Yes, you can read iMessage chat history through the terminal. The imsg CLI allows you to list chats and retrieve message history programmatically, enabling text archival workflows directly from macOS.

What do I need to automate messaging with the imsg CLI?

To automate messaging with the imsg CLI, you need a macOS system with Messages.app signed in and the imsg binary installed via Homebrew. This setup allows programmatic access to your chats.

How do I monitor for new iMessages for automated workflows?

You monitor new iMessages for automated workflows by executing imsg CLI commands to watch for incoming texts. This enables macOS messaging automation by triggering actions when new SMS or iMessages arrive.

Does the imsg CLI work without signing into Messages.app on macOS?

No, the imsg CLI does not work without signing into Messages.app on macOS. The tool relies on the native application's active session to route SMS and iMessages successfully from the command line.