imsg — iMessage/SMS CLI

Trust Score 88/100

Read iMessage/SMS chats, view history, and send messages via macOS Messages.app using the imsg CLI (requires macOS and Messages access).

triggers:send imessagesend smslist chatsview historyimsg climessages.app

GitHub SKILL.md

What it does

The imsg skill enables an agent to interact with macOS Messages.app via the imsg command-line tool: listing chats, viewing conversation history (with optional attachments), watching for new messages, and sending iMessage or SMS to phone numbers or Apple IDs. It includes usage examples and safety checks for confirming recipients and content.

When to use it

Use this skill when a user asks the agent to send an iMessage or SMS, to inspect recent Messages.app chats, or to fetch message history. Not appropriate for Telegram, Signal, WhatsApp, or bulk messaging—those channels use other skills. Requires a macOS host with Messages.app signed in and automation permissions.

What's included

Scripts: none embedded in the SKILL.md (has_scripts=false)
References: none listed (has_references=false)
Instructions: CLI examples for listing chats, viewing history, watching a chat, and sending messages (text or with attachments). Service options (imessage/sms/auto) and safety rules (confirm recipients, avoid unknown numbers, rate limiting) are documented.

Compatible agents

Agents that can run commands on a macOS host with terminal automation and have access to Messages.app (local macOS automation agents, personal assistant agents with macOS integration).

Audit Summary

iMessage/SMS CLI skill for macOS Messages.app using the imsg binary. No bundled scripts — purely a documentation skill with clear commands for listing chats, viewing history, and sending messages. Includes sensible safety rules requiring user confirmation before sending. Limited to macOS with Messages.app signed in, which narrows the audience.

Watch Out

Requires macOS with Messages.app signed in
Requires Full Disk Access for terminal
Requires Automation permission for sending

Notes

Clean skill with no security concerns. Well-structured SKILL.md with clear trigger conditions and safety rules. Niche usefulness due to macOS-only requirement.

Information

Repository: understudy
Stars: 432

Trust Score

Overall88

Security95

Code Quality82

Architecture78

Usefulness55

More from understudy

xurl (X API CLI)

CLI wrapper for the X (Twitter) API that lets agents post, read, search, manage accounts, and upload media via scripted commands.

tmux Session Control

Send keystrokes and capture output from tmux sessions to automate interactive CLIs, monitor long-running processes, and manage terminal-based agents.

Related Skills

Development Worktree

Create an isolated git worktree for feature work, auto-run project setup, and verify a clean test baseline before development.

Readwise Reader Document Management

Manage Readwise Reader documents: list, save, search, move, tag, highlight, export and bulk-edit via official and custom CLIs.

Bounty Hunter — Atlas

Persona skill: 'Atlas' — a profit-focused developer persona for discovering, evaluating and executing paid bounties or freelance tasks with ROI-aware workflows.

Junshi — Research Advisor

Daily strategic research advisor that scans arXiv/venues, digests papers, and proposes bold, ranked research ideas tailored to the user's profile.

Full Stack Builder

End-to-end builder that scaffolds, implements, tests, and optionally deploys web and API applications from a natural-language specification.

ezBookkeeping API Tools

Command-line API tools for ezBookkeeping: record and query transactions, retrieve accounts/categories/tags, and fetch exchange rates for self-hosted personal fi

Feishu Voice Sender

Convert MP3s and send them as native Feishu voice messages (playable voice clips) to users or groups.

Claw Bench

Benchmarking skill that guides an agent through a structured suite of capability tests and reporting steps for leaderboard submission.

Back to Skills