imsg Actions
SkillCommunicationLets your agent read your iMessage chats and send texts or attachments through Messages on a Mac.
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
About this capability
iMessage/SMS CLI for listing chats, history, watch, and sending.
What this skill tells your AI
The instructions your AI receives, as published by bitterbot-ai/bitterbot-desktop 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
- 2k
- Forks
- 417
- Last commit
- Sep 2026
Others that do the same job
Advanced
- Catalog kind
- skill
- Gateway key
imsg-bitterbot-ai- Source
- github.com/bitterbot-ai/bitterbot-desktop