{"repo":"openclaw/imsg","free":true,"listed":false,"github":"https://github.com/openclaw/imsg","clone":"git clone https://github.com/openclaw/imsg.git","description":"CLI for Apple's Messages.app so your agent can send and receive text messages/iMessages.","language":"Swift","stars":1281,"topics":["cli","imessage"],"license":"MIT","category":"cli-tools","readme_excerpt":"imsg 💬 — Messages, piped. imsg is a Swift CLI for reading, watching, and sending iMessage and SMS from macOS. It reads the local Messages database, sends through Messages.app automation, and exposes NDJSON and JSON-RPC for scripts and agents. That's the whole pitch: read directly, stream updates, and ask Messages.app to send. Install Homebrew is the smallest path on macOS: imsg requires macOS 14 or newer. Signed macOS builds and Linux x86 64 read-only builds are also available from GitHub Releases. Linux reads a chat.db copied from macOS; it does not connect to iMessage or send messages. See the Linux guide. Quick start Grant your terminal Full Disk Access in System Settings → Privacy & Security , then reopen it. imsg needs that permission to read /Library/Messages/chat.db . Use an id from the first command in place of 42 . The five-minute quickstart continues with live watching and sending. Core workflows Goal Start here --- --- List chats and inspect their identifiers Chats and groups Read or search local history History Stream new messages and tapbacks Watch Send text, files, and standard tapbacks Send and attachments Count messages and media Statistics Consume stable NDJSON or a long-running stdio API JSON schema and JSON-RPC Generate shell completions or model-ready CLI help Completions Read commands open the database in SQLite read-only mode. watch follows database and WAL filesystem events, with a polling fallback when macOS drops an event or rotates a sidecar file. P","default_branch":null,"files":null,"tree":[],"storefront":"/r/openclaw","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/openclaw/imsg/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}