imessage

Send and receive iMessages/SMS via the macOS command line using imsg.

Updated May 11, 2026
One-click install
npx skills add https://github.com/richardnguyen0715/keep-it-real --skill imessage-richardnguyen0715
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/richardnguyen0715/keep-it-real/tree/main/refer-projects/hermes-agent/skills/apple/imessage
Command: npx skills add https://github.com/richardnguyen0715/keep-it-real --skill imessage-richardnguyen0715

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of sending and receiving iMessages/SMS via the command line, offering a more efficient way to manage messaging on macOS.

Core Features & Use Cases

  • Send and Receive Messages: Directly send and receive iMessages/SMS without opening the Messages.app.
  • View Chat History: Retrieve conversation history with attachments.
  • Monitor New Messages: Watch for new messages with attachment notifications.
  • Use Cases: Quickly send a message to a friend or family member, view the entire conversation history, or keep an eye on new messages while working on other tasks.

Quick Start

Send a text message to +14155551212 with the content "Hello!" using the imsg send command.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send and receive iMessages from the command line on macOS?

You can send and receive iMessages directly from the macOS command line by using the imsg CLI tool to interact with the native Messages.app without opening the graphical interface.

Can I retrieve iMessage chat history and attachments using the terminal?

Yes, retrieving iMessage chat history and attachments via the terminal is supported, allowing you to view entire conversation histories directly in your command line environment.

How do I monitor new SMS messages on macOS while working in the terminal?

You can monitor new SMS messages on macOS by running a watch command in your terminal, which notifies you of incoming messages and attachments without needing to open the Messages.app.

Do I need the imsg CLI tool to manage SMS messages from the macOS terminal?

Yes, the imsg CLI tool is a required dependency for managing SMS messages from the macOS terminal, and you must also grant appropriate permissions on your device for it to function correctly.

What is the best way to automate sending iMessages without opening the Messages app?

Automating iMessage sending without opening the app is best achieved through command line scripts utilizing the imsg CLI tool, enabling quick message dispatch directly from your macOS terminal.