imessage

Send and receive iMessages via the imsg CLI on macOS.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/quiznat/Hermes_Sapho --skill imessage-quiznat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/quiznat/Hermes_Sapho/tree/main/.hermes/skills/apple/imessage
Command: npx skills add https://github.com/quiznat/Hermes_Sapho --skill imessage-quiznat

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Traditional iMessage automation requires manual interaction with Messages.app; this Skill enables CLI-based iMessage communication for scripting and automation on macOS.

Core Features & Use Cases

  • List chats and read conversation history from the terminal.
  • Send iMessages or SMS messages to contacts via the imsg tool.
  • Integrate messaging into automated workflows and batch processes.

Quick Start

Send an iMessage to a contact using the imsg CLI with the text 'Hello'.

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 terminal by using the imsg CLI tool to automate text delivery. This Skill routes your message payloads through the Messages.app framework without requiring manual GUI interaction.

Can I list chats and view iMessage history via command line?

Yes, listing chats and viewing conversation history via command line is supported. The Skill leverages the imsg CLI on macOS to retrieve and display your past iMessage interactions directly in the terminal output.

Does iMessage terminal automation work without Messages.app?

No, iMessage terminal automation requires macOS with Messages.app access. The Skill acts as a CLI wrapper around the imsg tool, which depends on the native macOS messaging environment to validate recipients and route texts.

How do I install the imsg CLI tool for scripting communications?

To install the imsg CLI tool for scripting communications, you must use Homebrew on your macOS system. Once installed, the Skill can automate sending messages, customer updates, and status notifications through the terminal.

What safeguards are applied when sending automated iMessages?

When sending automated iMessages, the Skill applies safeguards for recipient validation and permission prompts. This ensures your scripted communications only dispatch to verified contacts after receiving the required macOS system authorizations.

Why use a CLI tool instead of AppleScripts for iMessage automation?

Using a CLI tool for iMessage automation provides a cleaner interface for batch processing and scripted workflows. This approach avoids the overhead of AppleScripts by integrating message dispatching directly into standard terminal commands.