imessage

Sends and reads text messages from the terminal via the user's own device.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your terminal and the macOS Messages application, allowing you to manage communications without leaving your command-line interface.

Core Features & Use Cases

  • Message Management: Read conversation history and send new messages directly from the terminal.
  • Contextual Awareness: Retrieve specific chat threads or check recent messages using JSON-formatted output.
  • Use Case: If you are working in a terminal and need to quickly text a colleague or check a verification code sent to your phone, this skill allows you to perform these actions without switching context to the Messages app.

Quick Start

Use the imessage skill to send a text message to a specific phone number or contact.

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?

This skill facilitates sending iMessages from the macOS terminal by executing commands through the imsg CLI utility. It programmatically bridges your command-line interface directly to the Messages app.

Can I retrieve SMS chat history using a CLI on macOS?

Yes, you can retrieve SMS chat history using a CLI on macOS by querying conversation threads through this skill. It supports filtering by contact and outputs recent messages in JSON format for terminal-based contextual awareness.

Do I need special macOS permissions to automate text messaging via CLI?

Yes, automating text messaging via CLI requires special macOS privacy permissions for full disk access and automation. You must also have the imsg binary installed on your macOS system to execute the messaging commands.

What is the best way to read a verification code sent to my phone without leaving the terminal?

The best way to read a verification code without leaving the terminal is using this skill to query recent SMS messages. It retrieves incoming texts via the imsg CLI utility and returns the output in JSON format for quick parsing.

Does the imsg CLI utility support filtering message history by contact?

Yes, the imsg CLI utility supports filtering message history by specific contacts. This skill leverages that capability to retrieve specific chat threads and check recent messages programmatically from your macOS terminal.