imessage

Send and receive iMessages and SMS from the macOS terminal via imsg.

539|39|Updated May 1, 2026
One-click install
npx skills add https://github.com/Tommy-yw/RunbookHermes --skill imessage-tommy-yw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Tommy-yw/RunbookHermes/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Tommy-yw/RunbookHermes --skill imessage-tommy-yw

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the process of sending and receiving iMessages/SMS on macOS, allowing users to manage their messaging from the command line.

Core Features & Use Cases

  • Send and Receive Messages: Communicate with contacts via iMessage or SMS directly from the terminal.
  • History and Chats: View conversation history and manage chats.
  • Use Case: If you need to send an urgent message and don't want to navigate through the Messages app, this Skill provides a quick and efficient way to do so.

Quick Start

Use the imsg send --to "+14155551212" --text "Hello!" command to send an iMessage to a specific contact.

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?

To send iMessages from the macOS terminal, use the `imsg send` command with the recipient's phone number and text. This routes your message directly through the native Messages app without opening the GUI.

Can I view iMessage conversation history in the command line?

Yes, you can view iMessage conversation history in the command line. The Skill utilizes the imsg CLI to access Messages.app data, allowing you to retrieve and manage past chats directly within your terminal interface.

Do I need macOS to send and receive SMS via the terminal?

Yes, you need macOS to send and receive SMS via the terminal. The Skill relies on the macOS Messages.app and the imsg CLI to function, so it cannot operate on Windows or Linux environments.

What is the best way to automate sending SMS on macOS?

The best way to automate sending SMS on macOS is using a command-line interface. This Skill enables quick communication with contacts via terminal commands, bypassing the Messages app for urgent or scripted messages.

Why use a command-line interface for iMessage instead of the Messages app?

Using a command-line interface for iMessage provides a quick and efficient way to communicate. It is designed for users who need to send urgent messages or manage chats without navigating through the graphical Messages app.