skills.rest
perasyudha
perasyudhaCOMMUNITY
Explore all skills by this author →
Website𝕏@Nyxora_AIGitHub

imessage

Send and read iMessage and SMS messages via the imsg CLI on macOS.

5|2|Updated May 26, 2026
Search Tags:#messaging#cli#macos#sms#imessage#imsg#send text
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill imessage-perasyudha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/apple/imessage
Command: npx skills add https://github.com/perasyudha/Nyxora --skill imessage-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets an AI agent read chat history and send iMessage or SMS texts through macOS Messages.app without manual interaction with the Messages interface. ## Core Features & Use Cases - List and Inspect Chats: Retrieve recent conversations with imsg chats and view message history by chat ID, including attachment info. - Send Messages with Attachments: Send text and files to phone numbers or Apple IDs, with control over iMessage versus SMS delivery. - Watch for Incoming Messages: Monitor a chat in real time using imsg watch. - Use Case: A user says "Text mom that I'll be late" — the agent finds Mom's chat, confirms the recipient and content, then sends the message via imsg send. ## Quick Start Ask the agent to send an iMessage to a specific phone number with your message text, and confirm the recipient before it sends.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send an iMessage from the command line on macOS?▼

Use the imsg CLI with `imsg send --to "+14155551212" --text "Hello!"` to send a message through Messages.app. Add `--file` to attach files and `--service imessage` or `--service sms` to force a delivery method.

How do I read iMessage history from the terminal?▼

Run `imsg chats --limit 10 --json` to list recent conversations, then `imsg history --chat-id <id> --limit 20 --json` to view messages. Add `--attachments` to include attachment information in the output.

What permissions does imsg need on macOS?▼

The terminal needs Full Disk Access granted in System Settings under Privacy, plus Automation permission for Messages.app when prompted. Messages.app must also be signed in with an Apple ID.

Can I force SMS instead of iMessage when sending a text?▼

Yes, pass `--service sms` to force SMS delivery or `--service imessage` to require iMessage. The default `--service auto` lets Messages.app decide based on the recipient.

What are the limitations of sending messages with imsg?▼

It only works on macOS with Messages.app signed in and cannot manage group chat membership. Bulk messaging is discouraged, and sending to unknown numbers requires explicit user approval.

Related Skills

Explore More Personal & Entrepreneur Skills→
rickyanandarickyananda
1

imessage

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

Community
Intermediate
LogarnLogarn
1

followups

Track sent messages awaiting responses across email, Slack, and WhatsApp channels.

Community
Intermediate
TheophilusChinomonaTheophilusChinomona
2

openclaw-channels

Configure messaging channel integrations for the OpenClaw AI gateway.

Community
Intermediate
Vero-VenturesVero-Ventures

twilio

Manage Twilio SMS operations via REST API for sending messages and checking logs.

Official
Intermediate