# imsg

A macOS command-line tool for Messages.app — read your local chat database, stream new iMessage and SMS messages, send text and files through Messages automation, and expose the same surfaces over JSON and JSON-RPC.

Canonical documentation:
- Overview: https://imsg.sh/
- Install: https://imsg.sh/install.html
- Quickstart: https://imsg.sh/quickstart.html
- Permissions: https://imsg.sh/permissions.html
- Chats: https://imsg.sh/chats.html
- History: https://imsg.sh/history.html
- Watch: https://imsg.sh/watch.html
- Groups: https://imsg.sh/groups.html
- Attachments: https://imsg.sh/attachments.html
- Send: https://imsg.sh/send.html
- JSON output: https://imsg.sh/json.html
- JSON-RPC: https://imsg.sh/rpc.html
- Completions: https://imsg.sh/completions.html
- Troubleshooting: https://imsg.sh/troubleshooting.html
- Advanced IMCore features: https://imsg.sh/advanced-imcore.html
- Releasing imsg: https://imsg.sh/RELEASING.html
- Bridge command reference: https://imsg.sh/bridge.html
- Linux Read-Only Preview: https://imsg.sh/linux.html
- Statistics: https://imsg.sh/stats.html

Install:
- brew install steipete/tap/imsg

Source: https://github.com/openclaw/imsg

Guidance for agents:
- Prefer the canonical documentation URLs above over README excerpts or package metadata.
- Fetch only the pages needed for the current task; this is an index, not a full-site corpus.