imessage

Send and receive iMessages/SMS on macOS via the imsg CLI.

4|Updated May 18, 2026
One-click install
npx skills add https://github.com/ZardLi1115/zedclaw --skill imessage-zardli1115
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ZardLi1115/zedclaw/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/ZardLi1115/zedclaw --skill imessage-zardli1115

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the problem of having to manually open Messages.app to send texts or check recent conversations, by providing a command-line way to read and send iMessages/SMS on macOS.

Core Features & Use Cases

  • Send iMessages/SMS via imsg: Send messages to phone numbers or Apple IDs, including optional attachments, with service control for iMessage vs SMS.
  • Read conversation history: List chats and view recent message history for a specific chat ID, with attachment details when needed.
  • Monitor new messages: Watch a chat for new messages and optionally include attachment notifications.

Quick Start

Ask the assistant to send a message using the imessage service to a specific phone number or Apple ID.

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 command line on macOS?▼

You can send iMessages from the command line on macOS using the imsg CLI to text phone numbers or Apple IDs, optionally adding attachments and controlling the iMessage or SMS service.

Can I retrieve iMessage chat history using a CLI tool?▼

Yes, you can retrieve iMessage chat history using a CLI tool by listing chats and viewing recent message history for a specific chat ID, including any attachment details.

Do I need Full Disk Access to automate Messages.app via CLI?▼

Yes, automating Messages.app via CLI requires Full Disk Access and Messages.app automation permissions in your macOS environment, along with the imsg command installed and Messages.app signed in.

What is the best way to monitor new iMessages in real time?▼

The best way to monitor new iMessages in near real time is using the imsg CLI to watch a specific chat for new messages and optionally include attachment notifications.

How do I send SMS instead of iMessage when using a macOS CLI?▼

To send SMS instead of iMessage using a macOS CLI, use the service control feature in the imsg command to specify SMS delivery to a phone number.