skills.rest
swcstudiospace
swcstudiospaceOFFICIAL
Explore all skills by this author →
Website𝕏@govantarcticaGitHub

imessage

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

Updated Aug 19, 2026
Search Tags:#messaging#cli#macos#sms#imessage#imsg#send message
One-click install
npx skills add https://github.com/swcstudiospace/aimeecodes --skill imessage-swcstudiospace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/swcstudiospace/aimeecodes/tree/main/.aimee/skills/imessage
Command: npx skills add https://github.com/swcstudiospace/aimeecodes --skill imessage-swcstudiospace

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

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 the option to force iMessage, SMS, or automatic service selection. - Watch for Incoming Messages: Monitor a conversation 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 contact or 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 the send command: imsg send --to "+14155551212" --text "Hello!". You can attach files with --file and force iMessage or SMS delivery using the --service flag.

How do I read iMessage history from the terminal?▼

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

What permissions does imsg need on macOS?▼

imsg requires Full Disk Access for the terminal, 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 imsg send SMS instead of iMessage?▼

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

What are the limitations of sending messages with imsg?▼

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

Related Skills

Explore More Personal & Entrepreneur Skills→
kaminocorpkaminocorp
1

imessage

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

Official
Basic
jbreel77888jbreel77888

draft-outreach

Automate prospect research and draft personalized email and LinkedIn outreach messages.

Community
Intermediate
chenguojun06-starchenguojun06-star
1

lark-contact

Resolve Feishu/Lark employee names or emails into open_id identifiers.

Community
Intermediate
ToqsickToqsick

messaging-gateway-setup

Configure messaging platforms via Hermes gateway with bot creation and token management.

Community
Intermediate