imessage

Send and receive iMessage or SMS messages on macOS via the imsg CLI.

Updated Apr 10, 2026
One-click install
npx skills add https://github.com/VYRE-Studios/Windows-Agentic-Framework --skill imessage-vyre-studios
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/VYRE-Studios/Windows-Agentic-Framework/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/VYRE-Studios/Windows-Agentic-Framework --skill imessage-vyre-studios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It provides a way to send and receive iMessage or SMS messages directly from the command line on macOS, eliminating the need to switch to the Messages GUI for simple messaging tasks.

Core Features & Use Cases

  • List Chats: Retrieve recent conversation threads.
  • View History: Fetch message history with optional attachment details.
  • Send Messages: Dispatch text or media to contacts via iMessage or SMS.
  • Watch for New Messages: Monitor incoming messages in real time.
  • Safety Rules: Includes confirmation prompts, recipient verification, and rate‑limiting to prevent misuse.

Quick Start

Ask the iMessage skill to send a text message saying "Hello" to +14155551212 via iMessage.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessage or SMS from the macOS command line?

You can send iMessage or SMS from the macOS command line by using the imsg CLI tool to dispatch text or media to contacts via the Messages app. This skill requires installing imsg via Homebrew and granting Full Disk Access and Automation permissions to operate.

Can I retrieve chat history and attachments using CLI messaging on macOS?

Yes, you can retrieve chat history and attachments using CLI messaging on macOS. The skill reads recent conversation threads and fetches message histories with optional attachment details directly through the imsg command-line interface without opening the Messages GUI.

Do I need to grant Full Disk Access to use a CLI tool for macOS messaging?

Yes, granting Full Disk Access and Automation permissions for Messages.app is required to use a CLI tool for macOS messaging. The imsg command-line tool needs these system permissions to read chat histories and transmit texts successfully.

How do I monitor incoming iMessage texts in real time via CLI?

To monitor incoming iMessage texts in real time via CLI, use the watch feature of the imsg tool. This monitors incoming messages directly on macOS without needing to keep the Messages graphical application actively open.

Are there safety features to prevent misuse when automating SMS sending?

Yes, there are safety features to prevent misuse when automating SMS sending. The skill includes built-in confirmation prompts, recipient verification, and rate-limiting rules to ensure secure command-line messaging through the macOS Messages app.