imsg Actions
SkillCommunicationiMessage/SMS CLI for listing chats, history, watch, and sending.
Available today. Use it from your connected AI after setup.
No other account needed.
Connect ahel once, and every AI you use reads what you have installed.
Then ask your AI: use the imsg Actions skill
What this skill tells your AI
The instructions your AI receives, as published by njx-njx/opensoul in skills/imsg/SKILL.md and read by ahel’s review.
Overview
Use imsg to read and send Messages.app iMessage/SMS on macOS.
Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
Inputs to collect
- Recipient handle (phone/email) for
send chatIdfor history/watch (fromimsg chats --limit 10 --json)textand optionalfilepath for sends
Actions
List chats
imsg chats --limit 10 --json
Fetch chat history
imsg history --chat-id 1 --limit 20 --attachments --json
Watch a chat
imsg watch --chat-id 1 --attachments
Send a message
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
Notes
--service imessage|sms|autocontrols delivery.- Confirm recipient + message before sending.
Ideas to try
- Use
imsg chats --limit 10 --jsonto discover chat ids. - Watch a high-signal chat to stream incoming messages.
Signals
- GitHub stars
- 56
- Forks
- 8
- Last commit
- Jun 2026
ahel recommends instead
Advanced
- Catalog kind
- skill
- Gateway key
imsg-njx-njx- Source
- github.com/njx-njx/opensoul