imsg

Send iMessage/SMS messages and control macOS Messages.app from terminal scripts.

3|2|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/yoonhwan/ai-feature-pack --skill imsg-yoonhwan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/yoonhwan/ai-feature-pack/tree/main/feature-pack/imsg/skill
Command: npx skills add https://github.com/yoonhwan/ai-feature-pack --skill imsg-yoonhwan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of being unable to send iMessage/SMS messages or control macOS Messages.app from terminal environments and automated workflows, removing the need to manually interact with the Messages app for routine messaging or agent notification tasks.

Core Features & Use Cases

  • Chat & History Management: View your iMessage/SMS conversation list and retrieve filtered message history directly from the terminal.
  • Message Sending: Send text messages and file attachments to phone numbers, emails, or existing chat IDs via iMessage or SMS, with selectable service types.
  • Real-time Monitoring: Watch for incoming iMessage/SMS messages in real time to trigger automated responses or alerts.
  • Use Case: A developer running a long automated coding task can use this Skill to send a completion alert to their phone, or pull recent message history to check for client updates without leaving their terminal workflow.

Quick Start

Use the imsg skill to send a success alert with the text "Data processing complete" to your pre-saved phone number as soon as your data pipeline script finishes running.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessage or SMS alerts from a terminal script?

You can send iMessage or SMS alerts from a terminal script by using the imsg CLI to send text messages and file attachments to phone numbers or emails. This requires macOS with a configured Messages.app and terminal Full Disk Access.

Can I retrieve iMessage chat history from the command line?

Yes, you can retrieve filtered iMessage chat history directly from the command line. The imsg CLI supports querying your conversation list and retrieving specific message history without needing to open the Messages.app.

Does sending iMessage from the terminal require special macOS permissions?

Yes, sending iMessage from the terminal requires macOS Full Disk Access and Messages Automation permissions for your terminal environment. You also need the imsg CLI installed via Homebrew and a configured Messages.app.

What is the best way to monitor incoming SMS messages for automated agent alerts?

The best way to monitor incoming SMS messages for automated agent alerts is using real-time monitoring features in the imsg CLI. It watches for incoming iMessage or SMS messages to trigger automated responses or cron job alerts.

How do I send file attachments via iMessage using an automated cron job?

You can send file attachments via iMessage using an automated cron job by executing the imsg CLI within your script. It supports sending file attachments to existing chat IDs or phone numbers with selectable service types like iMessage or SMS.