Imsg

iMessage/SMS CLI for listing chats, history, watch, and sending.

Peter Steinberger

@steipete

What This Skill Does

Command-line interface for reading and sending iMessage/SMS on macOS. Lists chats, fetches message history with attachments, watches for new messages, and sends texts or files through Messages.app.

Replaces manually clicking through Messages.app by exposing chat listing, history, watch, and send actions as shell-accessible commands.

When to Use It

  • List recent iMessage chats with JSON output for scripting
  • Fetch message history from a specific chat including attachments
  • Watch a chat for new incoming messages in real-time
  • Send an iMessage or SMS with text and an attached file from the terminal

Install

$ openclaw skills install @steipete/imsg

imsg

Use imsg to read and send Messages.app iMessage/SMS on macOS.

Requirements

  • Messages.app signed in
  • Full Disk Access for your terminal
  • Automation permission to control Messages.app (for sending)

Common commands

  • List chats: imsg chats --limit 10 --json
  • History: imsg history --chat-id 1 --limit 20 --attachments --json
  • Watch: imsg watch --chat-id 1 --attachments
  • Send: imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg

Notes

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

Top skills in this category