imessage

Read and send iMessage from the command line on macOS.

Updated Jun 1, 2026
One-click install
npx skills add https://github.com/SatangThevalue/ai-skills --skill imessage-satangthevalue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/SatangThevalue/ai-skills/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/SatangThevalue/ai-skills --skill imessage-satangthevalue

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline macOS iMessage interactions by controlling Messages.app from the command line, enabling automation and quick responses without opening the app.

Core Features & Use Cases

  • Read and list iMessage chats from the terminal to quickly locate conversations.
  • Send iMessage or SMS messages via the imsg CLI with optional attachments and service options.
  • Retrieve recent messages and chat history to inform follow-up actions.

Quick Start

List chats with imsg chats to locate a contact, then send a message with imsg send after user confirmation.

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

To send iMessages from the macOS command line, use the imsg CLI tool to dispatch messages after confirming the recipient and content, requiring macOS with Messages.app signed in.

Can I read iMessage chat history using a CLI on macOS?

Yes, you can read iMessage chat history on macOS by running imsg commands to list active chats and retrieve recent message logs directly within the terminal.

What do I need to automate SMS messaging on macOS?

Automating SMS messaging on macOS requires a signed-in Messages.app, the installed imsg CLI utility, and explicit user confirmation before any text is dispatched.

Does sending iMessages via terminal support attachments?

Yes, sending iMessages through the macOS terminal supports optional attachments and service selection, allowing you to transmit files alongside standard text dispatch.

Can I watch for new iMessages without opening the Messages app?

You can watch for new iMessages without opening the app by executing terminal commands that monitor individual chats for incoming texts across your macOS system.

What are the limitations of automating iMessage sending through a CLI?

A key limitation of automating iMessage sending through a CLI is the mandatory user confirmation step before dispatching messages, ensuring deliberate transmission to prevent accidental texts.