imessage

Send and review iMessage and SMS conversations on macOS via imsg CLI.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill imessage-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Signmanal/VIGIL/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Signmanal/VIGIL --skill imessage-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually sending iMessages/SMS or pulling message history on macOS requires interacting with the Messages app directly, which is inefficient for security analysts who need to quickly communicate during triage or collect message evidence for investigations.

Core Features & Use Cases

  • Automated Messaging: Send iMessages or SMS to phone numbers or Apple IDs, with optional file attachments, without opening the Messages app.
  • Conversation Review: Pull recent chat history and metadata to quickly find context or evidence related to an investigation.
  • Use Case: A security analyst can instantly text a colleague a suspicious file link during alert triage, or retrieve recent message history with a known malicious actor for evidence documentation.

Quick Start

Use the imessage skill to send an iMessage to +1555123456 saying you will be late.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I automate sending iMessages or SMS on macOS for security operations?

You can automate sending iMessages or SMS on macOS by using the imsg CLI tool to programmatically send texts and file attachments to phone numbers or Apple IDs without opening the Messages app.

Can I retrieve iMessage chat history for evidence collection during an investigation?

Yes, you can retrieve iMessage chat history for evidence collection by pulling recent conversation logs and metadata directly from macOS systems to review context related to an investigation.

Do I need Full Disk Access to programmatically read and send iMessages on macOS?

Yes, you need Full Disk Access and Automation permissions for both the terminal and Messages.app, plus an active Messages.app account on a macOS device to programmatically send and receive iMessages.

What is the best way to send a file attachment to a colleague during alert triage?

The best way to send a file attachment during alert triage is using the imsg CLI tool, which allows security analysts to instantly transmit files via iMessage without manual app interaction.

Are there limitations when using the imsg CLI tool for SMS communication on macOS?

Limitations of using the imsg CLI tool include requiring a macOS device with an active Messages.app account and needing explicit Full Disk Access and Automation permissions configured for the terminal.

Does the imessage skill work with third-party messaging platforms or only Apple Messages?

The imessage skill works exclusively with Apple Messages on macOS, sending and receiving iMessages and SMS through the native Messages.app infrastructure rather than third-party platforms.