imsg
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
npx skills add Health-Yang/MineEcho --skill imsg --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# imsg Use `imsg` to read and send iMessage/SMS via macOS Messages.app. ## When to Use Use when: - User explicitly asks to send iMessage or SMS - Reading iMessage conversation history - Checking recent Messages.app chats - Sending to phone numbers or Apple IDs ## When NOT to Use Do not use when: - Telegram messages -> use `message` tool with `channel:telegram` - Signal messages -> use Signal channel if configured - WhatsApp messages -> use WhatsApp channel if configured - Discord messages -> use `message` tool with `channel:discord` - Slack messages -> use `slack` skill - Group chat management (adding/removing members) -> not supported - Bulk/mass messaging -> always confirm with user first - Replying in current conversation -> just reply normally (OpenClaw routes automatically) ## Requirements - macOS with Messages.app signed in - Full Disk Access for terminal - Automation permission for Messages.app (for sending) ## Common Commands ### 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 ``` ### Watch for New Messages ```
- When to Use
- When NOT to Use
- Requirements
- Common Commands
- List Chats
- View History
- Watch for New Messages
- Send Messages
- Service Options
- Safety Rules
- Example Workflow
imsg chats --limit 10 --json By chat ID imsg history --chat-id 1 --limit 20 --json With attachments info imsg history --chat-id 1 --limit 20 --attachments --json imsg watch --chat-id 1 --attachments Text only imsg send --to "+14155551212" --text "Hello!" With attachment imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg
What does the imsg skill do?
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
How do I install it?
Run `npx skills add Health-Yang/MineEcho --skill imsg --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From Health-Yang/MineEcho, a repository with 248 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.