imessage

Read and send iMessages/SMS via the imsg CLI on macOS.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/ar0cket1/Hermes-Agent-Online-RL --skill imessage-ar0cket1
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ar0cket1/Hermes-Agent-Online-RL/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/ar0cket1/Hermes-Agent-Online-RL --skill imessage-ar0cket1

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users often rely on graphical apps for iMessage and SMS, making automation and scripted workflows difficult. This skill provides a command-line interface to read and send messages via iMessages/SMS using the imsg tool.

Core Features & Use Cases

  • Read recent conversations from Messages.app and view chat histories.
  • Send messages to phone numbers or Apple IDs directly from the terminal.
  • Integrate messaging actions into automation scripts and workflows on macOS.

Quick Start

Read a chat and send a message using the imsg CLI.

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 command line on macOS?

To send iMessages via the command line, this skill uses the imsg CLI to send messages to phone numbers or Apple IDs directly within your macOS terminal workflows.

Can I read and view iMessage chat histories using a CLI?

Yes, you can read recent conversations and view chat histories from Messages.app on macOS by executing imsg CLI commands in your terminal.

What do I need to automate SMS and iMessage workflows on macOS?

Automating messaging workflows requires macOS with Messages.app installed, the imsg CLI, and necessary system permissions to access Messages.app and your contacts.

Does this command line messaging skill work with regular SMS or just iMessage?

The skill supports both iMessage and SMS, allowing you to read conversations and send messages to phone numbers or Apple IDs through the imsg CLI.

What are the limitations of scripting Messages.app via the terminal?

Scripting Messages.app is limited to macOS environments and requires explicit system permissions to access the app and contacts for reading and sending messages.