imsg Actions
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
bash
imsg chats --limit 10 --json
Fetch chat history
bash
imsg history --chat-id 1 --limit 20 --attachments --json
Watch a chat
bash
imsg watch --chat-id 1 --attachments
Send a message
bash
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.