skills.rest
ruiyangruiyi
ruiyangruiyiCOMMUNITY
Explore all skills by this author →
GitHub

imessage

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

Updated May 26, 2026
Search Tags:#messaging#macos#command line#chat history#attachments#sms#imessage
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill imessage-ruiyangruiyi
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill imessage-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of manually sending and checking iMessage/SMS conversations by giving a reliable command-line workflow for reading recent chats and sending messages on macOS.

Core Features & Use Cases

  • Chat discovery: List iMessage/SMS chats to quickly identify the right thread.
  • History retrieval: Pull recent message history from a specific chat, including attachment metadata when needed.
  • Safe messaging & monitoring: Send text (and optional attachments) with service targeting, and watch a chat for new incoming messages.

Use case: You want to quickly find your contact’s chat, confirm the exact recipient and message text, and then send a timely update without switching to Messages.app.

Quick Start

Tell the agent to list your iMessage chats and find the one matching Mom so you can send her a message.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessage or SMS from the command line on macOS?▼

You can send iMessages or SMS from the macOS command line by using the imsg CLI to target a specific chat and execute a send operation with your text and optional attachments.

Can I retrieve iMessage chat history and attachment metadata via terminal?▼

Yes, you can retrieve iMessage chat history and attachment metadata via terminal by using the imsg CLI history operation to pull recent conversation records from a specific chat thread.

How do I monitor a chat for new incoming iMessages without opening the Messages app?▼

You monitor a chat for new incoming iMessages without opening the Messages app by running the imsg CLI watch operation, which tracks a specific chat thread for new incoming messages.

Do I need to grant special permissions to read and send iMessages through a CLI tool?▼

Yes, reading and sending iMessages through a CLI tool requires a macOS environment with explicit Messages.app access permissions granted to the terminal or agent executing the imsg commands.

What is the best way to find a specific iMessage chat thread before sending a message?▼

The best way to find a specific iMessage chat thread before sending a message is to use the imsg CLI chats operation, which lists all available iMessage and SMS conversations for quick identification.

Why is my iMessage CLI tool not working when trying to send attachments?▼

Your iMessage CLI tool might not work when sending attachments if the macOS environment lacks proper Messages.app access permissions or the imsg command does not support the required send operations.

Related Skills

Explore More Content & Communication Skills→
rnbenrnben

imessage

Read and send iMessages and SMS from the macOS command line via imsg.

Community
Intermediate
lemonlqflemonlqf

imsg

Send iMessages and SMS, list chats, and retrieve history via command line.

Community
Intermediate
UselessXuUselessXu

imsg

Automate iMessage and SMS tasks from the macOS terminal.

Community
Intermediate
srivtxsrivtx

imessage

Send and receive iMessages/SMS from the terminal via imsg CLI.

Community
Basic