imessage

Send iMessage and SMS messages via the macOS Messages.app command-line interface.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This Skill helps you send and review iMessage or SMS conversations from macOS without manually opening Messages.app and searching through chats.

Core Features & Use Cases

  • Chat lookup and history review: Find recent conversations and inspect message history, including attachments when needed.
  • Message sending: Send text messages or files to phone numbers or Apple IDs through the macOS Messages service.
  • Live monitoring: Watch a conversation for new incoming messages in real time.
  • Use case: A user asks to text a contact that they will be late, and this Skill can help locate the right recipient, confirm the message, and send it through iMessage or SMS.

Quick Start

Ask the assistant to send a message through iMessage to a specific contact after confirming the recipient and text content.

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 macOS without opening the Messages app?

You can send iMessages from macOS by using the imsg command-line interface, which routes text messages and files directly through the Messages.app service without manual GUI interaction.

Can I review iMessage chat history and attachments via the command line?

Yes, you can review iMessage chat history. The command-line interface allows you to look up recent conversations, inspect past messages, and retrieve attachments on Apple devices.

Do I need to sign into Messages.app to send SMS from the macOS terminal?

Yes, you must sign into Messages.app. Sending SMS or iMessages via the macOS terminal requires active Messages.app sign-in, the imsg CLI, and necessary privacy and automation permissions.

What's the best way to monitor live iMessage conversations in real time?

The best way to monitor live iMessage conversations is using the imsg CLI's live monitoring feature, which watches specific chat threads for new incoming messages in real time on macOS.

Why does sending an iMessage through macOS terminal fail to deliver?

Sending an iMessage through macOS terminal fails if you lack required privacy and automation permissions, are not signed into Messages.app, or have an invalid recipient phone number or Apple ID.

Can I use the imsg CLI to send files as attachments in Messages.app?

Yes, you can use the imsg CLI to send files. The tool supports attachment delivery, allowing you to send files directly to phone numbers or Apple IDs through the macOS Messages service.