imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users need a simple, CLI-based way to read and send iMessages and SMS from the terminal without switching between apps.

Core Features & Use Cases

  • Read iMessages and SMS via the imsg CLI on macOS.
  • Send messages to contacts or phone numbers.
  • View recent chats and conversation history from Messages.app.
  • Optionally force iMessage or SMS delivery when needed.

Quick Start

Read an iMessage conversation list and send a message to a contact using imsg.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send and read iMessages from the macOS terminal?

You can send and read iMessages from the macOS terminal by using the imsg CLI to access Messages.app. This allows you to view conversation histories and send messages to contacts directly without switching applications.

Can I force SMS delivery instead of iMessage for a contact on macOS?

Yes, you can optionally force SMS or iMessage delivery when sending a message via the imsg CLI. This provides targeted messaging control directly from your terminal on macOS.

Do I need the Messages.app installed to use an iMessage CLI tool?

Yes, macOS Messages.app access is a prerequisite for the imsg CLI to function. The tool reads conversations and routes messages through the native Messages application on your Mac.

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

Using a CLI tool like imsg is the best way to automate SMS replies on macOS without opening the Messages app. It enables quick replies and history checks directly from the terminal for personal communication flows.

How does the imsg CLI handle contact data when sending messages from the terminal?

The imsg CLI safely handles contact data by passing it directly to the Messages.app framework to route your messages. You can target messaging using phone numbers or contact names securely.

Why is my iMessage CLI tool not working on macOS?

An iMessage CLI tool may not work if the imsg tool is unavailable or if macOS Messages.app access is blocked. Ensure the CLI is installed correctly and has the required system permissions to read conversations.