imsg

name	imsg
description	iMessage/SMS CLI for listing chats, fetching history, watching conversations, and sending messages on macOS via the Messages app. Use when the user wants to send a text message, read iMessages, check recent texts, reply to a conversation, send an SMS, or interact with the Messages app from the terminal. Supports texting contacts by phone number or email, attaching files, and streaming incoming messages in real time. Use when this capability is needed.
metadata	{"author":"elizaos"}

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
• chatId for history/watch (from imsg chats --limit 10 --json)
• text and optional file path 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 "[phone]" --text "hi" --file /path/pic.jpg

Notes

• --service imessage|sms|auto controls delivery.
• Confirm recipient + message before sending.

Ideas to try

• Use imsg chats --limit 10 --json to discover chat ids.
• Watch a high-signal chat to stream incoming messages.

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.