imsg

Read and send iMessage/SMS from macOS via a command-line interface.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/isaaceliape/FASE --skill imsg-isaaceliape
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/isaaceliape/FASE/tree/main/skills/imsg
Command: npx skills add https://github.com/isaaceliape/FASE --skill imsg-isaaceliape

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and send iMessage/SMS from macOS via a command-line interface to automate conversations and messaging workflows.

Core Features & Use Cases

  • List chats: Quickly view recent conversations from the terminal.
  • History: Retrieve chat history and attachments for archiving or analysis.
  • Watch: Monitor a chat for new messages and trigger actions.
  • Send: Send messages to a contact or group directly from the terminal.
  • Use Case: Automate routine check-ins by sending scheduled messages to a contact list.

Quick Start

Use the imsg CLI on macOS to list chats or send a message.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send and read iMessage texts from the macOS terminal?

You can send and read iMessage texts from the macOS terminal using a command-line interface that directly interacts with Messages.app. It allows you to list chats, view history, watch for new messages, and send messages programmatically.

Can I automate sending scheduled SMS messages on macOS?

Yes, you can automate sending scheduled SMS messages on macOS by integrating the command-line interface with scheduling tools. This enables automated routine check-ins by sending messages directly to contacts from the terminal.

What do I need to monitor a chat for new iMessages via command line?

To monitor a chat for new iMessages via command line, you need a Mac with Messages.app access, the required macOS permissions, and the imsg binary installed locally. This setup allows you to watch chats and trigger actions.

How do I retrieve chat history and attachments from iMessage programmatically?

You can retrieve chat history and attachments from iMessage programmatically by executing the history command in the terminal interface. This extracts conversation archives directly from the local macOS Messages.app database for analysis.

Does this iMessage CLI tool work on operating systems other than macOS?

No, this iMessage CLI tool does not work on other operating systems. It requires a local macOS environment with Messages.app access and specific macOS permissions to read chats and send messages successfully.

What is the best way to list recent iMessage conversations in the terminal?

The best way to list recent iMessage conversations in the terminal is using the list chats command provided by the CLI. It quickly retrieves and displays recent active conversations directly from your Mac.