imessage

Send and receive iMessages or SMS via the macOS Messages.app command line.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/zerwiz/wayofpi --skill imessage-zerwiz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/zerwiz/wayofpi/tree/main/.hermes/hermes-agent/skills/apple/imessage
Command: npx skills add https://github.com/zerwiz/wayofpi --skill imessage-zerwiz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually sending, checking, and monitoring iMessages or SMS messages on macOS by exposing Messages.app through a command-line workflow.

Core Features & Use Cases

  • Message Sending: Send text messages to phone numbers or Apple IDs with support for choosing iMessage, SMS, or automatic delivery.
  • Conversation Review: List chats, inspect recent message history, and monitor incoming activity from the Messages database.
  • Attachment Support: Include files with outgoing messages when sharing images or other documents is required.
  • Use Case: A user can quickly text a contact, confirm recent chat activity, or attach a file without opening the Messages app manually.

Quick Start

Ask the assistant to use the imsg CLI to find the right conversation, confirm the recipient and message content, and send the message with any required attachment.

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 using the imsg CLI to interact with the macOS Messages.app. This requires Messages.app permissions and allows you to text contacts without opening the application manually.

Can I send SMS instead of iMessage using the macOS command line?

Yes, you can send SMS via the macOS command line. The imsg CLI supports optional service selection, allowing you to choose between iMessage, SMS, or automatic delivery for your outgoing messages.

What do I need to review chat history and monitor incoming messages on macOS?

To review chat history and monitor incoming messages, you need the imsg CLI and macOS Messages.app permissions. The tool accesses the Messages database to list chats and inspect recent activity directly from the terminal.

How do I share attachments and files with iMessage from the command line?

You can share attachments from the command line by including file paths when sending messages through the imsg CLI. This enables you to share images or documents without opening the Messages app.

Does sending iMessages from the terminal require a Mac?

Yes, sending iMessages from the terminal requires a Mac. The functionality relies on the macOS Messages.app command line interface and its underlying database, which are exclusive to the Apple ecosystem.

What are the limitations of automating Messages.app through the command line?

Automating Messages.app through the command line requires explicit permissions for terminal access to the Messages database. It is bound by macOS constraints and depends on the imsg CLI for execution and service selection.