imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This Skill removes the friction of messaging by letting you read iMessage/SMS history and send new texts from macOS via the imsg CLI, so you do not have to manually operate Messages.app for routine communication.

Core Features & Use Cases

  • Chat discovery and history: List chats and view recent conversation history, including attachment details when needed.
  • Message sending with safety guardrails: Send iMessage or SMS to a phone number or Apple ID, with optional attachments and explicit service selection.
  • New-message monitoring: Watch a chat for incoming messages to keep you updated without continuously checking the app.

Use case: You want to message someone from your current workflow (e.g., confirming you will be late), while quickly finding the correct chat and ensuring the recipient and content are correct before sending.

Quick Start

Use imessage to send an iMessage or SMS to +14155551212 with the text "Hello!".

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 using this Skill with the imsg CLI. It interfaces with macOS Messages.app to send texts and attachments to phone numbers or Apple IDs.

Can I view iMessage chat history and attachments without opening the Messages app?

Yes, you can list chats and review conversation history including attachment details in the terminal. This Skill queries macOS Messages.app data to display your messages without opening the app.

What do I need to automate SMS messaging from the macOS terminal?

You need macOS with Messages.app signed in, the imsg CLI installed, and terminal permissions for Full Disk Access and Messages.app automation to securely read and send SMS.

Is there a way to monitor incoming iMessages from a terminal script?

Yes, this Skill supports new-message monitoring to watch a chat for incoming texts. This keeps you updated on new SMS or iMessage conversations without checking the Messages app.

How can I send attachments via iMessage using terminal commands?

You can send attachments via iMessage using this Skill's sending feature, which supports optional file attachments alongside text to a specified phone number or Apple ID via the imsg CLI.