imessage

Send and read iMessages on macOS via the imsg CLI.

228|35|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/kaminocorp/hermes-alpha --skill imessage-kaminocorp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/kaminocorp/hermes-alpha/tree/main/hermes-agent/skills/apple/imessage
Command: npx skills add https://github.com/kaminocorp/hermes-alpha --skill imessage-kaminocorp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates sending and reading iMessages and SMS on macOS by interfacing with the imsg CLI, enabling terminal-based messaging workflows.

Core Features & Use Cases

  • Read chats and conversation history from Messages.app
  • Send iMessages or SMS to contacts or Apple IDs
  • Script and automate common iMessage tasks from the command line

Quick Start

Read the latest chat with a contact and reply with a predefined text 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 macOS terminal?

To send iMessages from the macOS terminal, you can use the imsg CLI to automate sending and reading messages. This allows terminal-based messaging workflows across contacts and Apple IDs without opening the Messages app.

Can I automate iMessage workflows via command line scripting?

Yes, you can automate iMessage workflows via command line scripting by interfacing with the imsg CLI. It enables you to script common messaging tasks, read conversation history, and send messages directly from macOS.

What macOS permissions are required to automate iMessage sending?

Automating iMessage sending requires macOS permissions including Full Disk Access and Automation. You also need Messages.app signed in and the imsg tool installed to ensure safe terminal-based operation.

Does the imsg CLI work with both iMessages and SMS on macOS?

Yes, the imsg CLI works with both iMessages and SMS on macOS. It interfaces with Messages.app to read chats, access conversation history, and send messages to contacts or Apple IDs.

How do I read iMessage conversation history from the command line?

To read iMessage conversation history from the command line, use the imsg CLI to interface with Messages.app. This terminal-based approach retrieves chats and conversation histories for specified contacts.

Why is my iMessage automation not working on macOS?

Your iMessage automation may not be working on macOS if required permissions are missing. Ensure Full Disk Access and Automation permissions are granted, Messages.app is signed in, and the imsg tool is properly installed.