Heldinhow

imsg

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

Heldinhow 4 Updated 7mo ago
GitHub

Install

npx skillscat add heldinhow/openclaw-swarm/imsg

Install via the SkillsCat registry.

About this skill

We need to produce a 2-3 sentence plain-text summary, objective, factual, no marketing language, no bullet points, no markdown, no quotes. At most 60 words. Must be plain text, no formatting. Provide only the summary text. We need to explain what the skill does, what problem it solves, when to use it. So something like: "The imsg skill provides a command‑line interface for macOS that lists iMessage/SMS conversations, retrieves chat history, monitors messages, and sends messages via the Messages app.

SKILL.md

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

imsg chats --limit 10 --json

Fetch chat history

imsg history --chat-id 1 --limit 20 --attachments --json

Watch a chat

imsg watch --chat-id 1 --attachments

Send a message

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.