Imsg

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

MIT-0 · Free to use, modify, and redistribute. No attribution required.
17 · 10.6k · 895 current installs · 909 all-time installs
byPeter Steinberger@steipete
MIT-0
Security Scan
VirusTotalVirusTotal
Suspicious
View report →
OpenClawOpenClaw
Benign
medium confidence
Purpose & Capability
The name/description (iMessage/SMS CLI) match the runtime instructions which call the 'imsg' CLI to list chats, history, watch, and send. Requiring Messages.app to be signed in and macOS permissions (Full Disk Access and Automation) is consistent with reading/sending Messages data.
Instruction Scope
SKILL.md only instructs using the 'imsg' CLI and documents expected flags and macOS permissions. It does not ask to read unrelated files, export data to external endpoints, or access unrelated credentials. It does reference local file paths for attachments (which is expected).
Install Mechanism
The skill is instruction-only (no code shipped), but its metadata recommends installing a Homebrew formula from the steipete/tap ('steipete/tap/imsg'). Installing from a third‑party tap is a moderate-risk install vector compared with an official Homebrew/core formula — you should review the formula/source before installing.
Credentials
The skill declares no environment variables, no credentials, and no config paths. The macOS permissions (Full Disk Access, Automation control of Messages.app) are sensitive but proportionate to an iMessage CLI that reads and sends Messages.
Persistence & Privilege
The skill is not set to always:true and does not request special platform-wide persistence. Model invocation is allowed (platform default); that is expected for a user-invocable skill and not a standalone concern here.
Assessment
This skill appears to do what it says: it's a wrapper around a macOS 'imsg' CLI. Before installing: (1) verify the Homebrew formula's source (the metadata points to the third‑party tap 'steipete/tap') — inspect the formula and its GitHub repo to ensure it's trustworthy; (2) be aware that granting Full Disk Access to your terminal and Automation permission for Messages.app allows the CLI to read your message database and attachments — only grant these to a terminal you trust or consider creating an isolated account/environment; (3) confirm recipients and review messages before sending (SKILL.md already advises this); and (4) if you need stronger assurance, prefer an official distribution or build the tool from source yourself. If you cannot review the brew tap or source, treat the install as higher risk.

Like a lobster shell, security has layers — review code before you run it.

Current versionv1.0.0
Download zip
latestvk972m4hp43f27bs1m68zesz9j17yk36k

License

MIT-0
Free to use, modify, and redistribute. No attribution required.

Runtime requirements

📨 Clawdis
OSmacOS
Binsimsg

Install

Install imsg (brew)
Bins: imsg
brew install steipete/tap/imsg

SKILL.md

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.

Files

1 total
Select a file
Select a file to preview.

Comments

Loading comments…