imessage

Send and receive iMessages/SMS via the imsg CLI on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill solves the issue of manually sending and receiving iMessages/SMS messages on macOS, providing a command-line interface for efficient communication.

Core Features & Use Cases

  • Command-Line Messaging: Send and receive iMessages/SMS via the imsg CLI.
  • Chat History: Retrieve conversation histories from Messages.app.
  • Message Sending: Send text and multimedia messages to phone numbers or Apple IDs.
  • Use Case: For users who prefer working with the command line and need a way to send quick messages without opening the Messages app.

Quick Start

Send an iMessage to mom's phone number using the imsg command: imsg send --to "+1555123456" --text "I'll be late."

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 command line on macOS?

You can send iMessages from the command line on macOS by using the imsg CLI to integrate with the local Messages.app, allowing you to text contacts without a graphical interface.

Can I retrieve chat history from Messages.app using the command line?

Yes, you can retrieve chat histories from Messages.app using the command line, as the imsg CLI supports reading conversation histories directly from your local macOS integration.

Do I need macOS Messages.app to send SMS via the command line?

Yes, you need macOS Messages.app configured locally because the command line messaging leverages the Messages.app integration to send and receive iMessages and SMS texts.

What is the best way to automate sending text messages on macOS without opening the Messages app?

The best way to automate sending text messages without opening the Messages app is using the imsg CLI, which enables efficient command-line messaging to phone numbers or Apple IDs.

Can I send multimedia messages via the command line using the imsg CLI?

Yes, you can send multimedia messages via the command line using the imsg CLI, which supports sending both text and multimedia messages directly to phone numbers or Apple IDs.

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

You would use a command line interface for iMessage to achieve efficient messaging capabilities without the overhead of a graphical interface, suitable for quick automated communication.