imessage

# iMessage Use `imsg` to read and send iMessage/SMS via macOS Messages.app. ## Prerequisites - **macOS** with Messages.app signed in - Install: `brew install steipete/tap/imsg` - Grant Full Disk Access for terminal (System Settings → Privacy → Full Disk Access) - Grant Automation permission for Messages.app when prompted ## When to Use - User asks to send an iMessage or text message - Reading iMessage conversation history - Checking recent Messages.app chats - Sending to phone numbers or Apple IDs ## When NOT to Use - Telegram/Discord/Slack/WhatsApp messages → use the appropriate gateway channel - Group chat management (adding/removing members) → not supported - Bulk/mass messaging → always confirm with user first ## Quick Reference ### List Chats ```bash imsg chats --limit 10 --json ``` ### View History ```bash # By chat ID imsg history --chat-id 1 --limit 20 --json # With attachments info imsg history --chat-id 1 --limit 20 --attachments --json ``` ### Send Messages ```bash # Text only imsg send --to "+14155551212" --text "Hello!" # With attachment imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg # Force iMessage or SMS imsg send --to "+14155551212" --text "Hi" --service imessage imsg send --to "+14155551212" --text "Hi" --service sms ``` ### Watch for New Messages ```bash imsg watch --chat-id 1 --attachments ``` ## Service Options - `--service imessage` — Force iMessage (requires recipient has iMessage) - `--service sms` ...