imessage

Read, search, send, and monitor iMessages via the imsg CLI.

3|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/mrap/hexagon-base --skill imessage-mrap
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/mrap/hexagon-base/tree/main/dot-claude/skills/imessage
Command: npx skills add https://github.com/mrap/hexagon-base --skill imessage-mrap

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows users to interact with their iMessage conversations directly from the command line, enabling them to read, search, send messages, and monitor incoming texts without leaving their terminal.

Core Features & Use Cases

  • Read Conversations: Access message history from specific chats or view recent messages.
  • Search Messages: Find specific information within message threads.
  • Send Messages: Compose and send new messages or replies, with or without attachments.
  • Real-time Monitoring: Watch for new incoming messages in real-time.
  • React to Messages: Add reactions to existing messages.
  • Use Case: A user needs to quickly find out what was discussed about a specific project in a group chat yesterday and then send a follow-up message to a participant.

Quick Start

Use the imessage skill to send a text message to +15551234567 with the content "Hello, are you free to chat?".

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 directly from the command line?

You can send and read iMessages from the command line by using the `imsg` CLI tool to locally access message history, search threads, and compose new texts without external network calls.

What macOS permissions are required to manage iMessage conversations via CLI?

Managing iMessage conversations via CLI requires granting specific macOS permissions for Messages.app and Full Disk Access to allow the `imsg` tool to read and interact with your local message database.

Can I search iMessage chat history and send attachments through a terminal?

Yes, you can search iMessage chat history and send attachments through a terminal by executing `imsg` commands to find specific information within threads and attach files to outgoing messages.

Is it possible to monitor incoming iMessages in real-time without opening the Messages app?

Yes, it is possible to monitor incoming iMessages in real-time without opening the Messages app by using the `imsg` CLI tool to watch for new incoming texts directly within your terminal environment.

Does CLI iMessage management work without external network calls?

Yes, CLI iMessage management works entirely locally without external network calls, processing all reading, searching, and sending actions through the native macOS Messages infrastructure.