imsg
iMessage/SMS CLI for listing chats, history, watch, and sending.
Source facts
- Repository
- sentientsprite/nemo-agent
- Last source activity
- February 12, 2026 at 02:59
- Detected SKILL.md language
- English
- Stars
- 1
- Forks
- 0
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- imsg
- description
- iMessage/SMS CLI for listing chats, history, watch, and sending.
- homepage
- https://imsg.to
- metadata
- {"nemo":{"emoji":"📨","os":["darwin"],"requires":{"bins":"[Truncated]"},"install":["[Truncated]"]}}
# 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
```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|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.
View on GitHub