imessage

Read and send iMessages from the terminal via macOS Messages.app.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage automation enables users to read and send iMessages from the terminal on macOS, reducing manual toggling between apps and accelerating messaging workflows.

Core Features & Use Cases

  • Read and list chats from Messages.app
  • View conversation history for a chat
  • Send text messages (with optional attachments)
  • Force service options (iMessage or SMS) when needed
  • Watch for new messages (real-time notifications)
  • Use Case: Notify a teammate when a task completes by sending a message via iMessage.

Quick Start

Install imsg, sign into Messages.app, grant terminal permissions, then run imsg chats to view your conversations.

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 terminal on macOS?

You can send iMessages from the terminal by installing the imsg CLI and granting Terminal automation permissions to access Messages.app. This enables command-line message sending with optional attachments.

Can I retrieve iMessage conversation history using a command line interface?

Yes, retrieving iMessage conversation history is possible via the imsg CLI on macOS. It lists chats from Messages.app and views specific conversation histories directly within the terminal.

Does iMessage automation require specific macOS configurations or dependencies?

iMessage automation requires macOS with Messages.app installed and signed in. Users must also grant explicit Terminal automation authorization and install the imsg CLI tool to enable messaging workflows.

What is the best way to monitor new iMessages in real-time?

The best way to monitor new iMessages in real-time is using the watch feature of the imsg CLI. It provides real-time notifications for new messages directly in the terminal without manual app checking.

Can I force iMessage or SMS delivery options when sending terminal messages?

Yes, you can force service options to send messages via iMessage or SMS. The imsg CLI allows explicit service selection when sending texts from the terminal to ensure delivery through the desired protocol.

Why is my iMessage CLI not working after installing imsg?

iMessage CLI issues often occur due to missing Terminal automation authorization or Messages.app not being signed in. Ensure macOS user permissions are explicitly granted to control the Messages app.