imessage

Send and read iMessages and SMS from the macOS terminal via imsg CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables sending and reading iMessages and SMS from the terminal on macOS by interfacing with Messages.app via the imsg CLI, streamlining quick communications without switching apps.

Core Features & Use Cases

  • List chats and view recent conversations from the command line.
  • Read message history for a given chat or contact.
  • Send text messages (and attachments if supported) to phone numbers or Apple IDs.
  • Watch for new messages and verify delivery status as needed.

Quick Start

Use imsg to read messages or send a text to a contact from the Terminal.

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 macOS terminal?

You can send iMessages from the macOS terminal by using the imsg CLI to interface with Messages.app. This skill facilitates sending text messages directly to phone numbers or Apple IDs without switching applications.

Can I view iMessage chat history from the command line?

Yes, you can view iMessage chat history from the command line. The imsg CLI allows you to list chats, view recent conversations, and read message history for specific contacts directly within the macOS terminal.

Does sending iMessages via terminal require the macOS Messages.app?

Yes, sending iMessages via terminal requires macOS with Messages.app installed. The skill operates by interfacing with the Messages.app through the imsg command line interface to read and send SMS or iMessages.

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

The best way to automate SMS sending on macOS without opening the Messages app is using the imsg CLI. It streamlines quick communications by enabling terminal-based sending to phone numbers and checking delivery status.

Can I send attachments through iMessage using the terminal CLI?

Yes, you can send attachments through iMessage using the terminal CLI if supported. The skill interfaces with imsg to handle chat IDs, attachments, and delivery checks while sending messages to Apple IDs or phone numbers.