imessage

Send and manage iMessages and SMS conversations via the macOS Messages.app command-line interface.

Updated Feb 21, 2026
One-click install
npx skills add https://github.com/Gitnapp/Skills --skill imessage-gitnapp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Gitnapp/Skills/tree/main/apple/imessage
Command: npx skills add https://github.com/Gitnapp/Skills --skill imessage-gitnapp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies sending, receiving, and reviewing iMessage or SMS conversations on macOS by providing a reliable command-line workflow through imsg.

Core Features & Use Cases

  • Message Management: Read chat history, list conversations, and monitor new Messages.app activity.
  • Message Sending: Send iMessages or SMS messages with support for text and attachments while enforcing confirmation safeguards.
  • Use Case: When a user needs to notify a contact, review a recent conversation, or automate a Messages.app interaction on a Mac, this Skill provides the required workflow.

Quick Start

Use the imessage skill to send a text message to a contact after confirming the recipient and message content.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessages from a Mac command line?

To send iMessages from a Mac command line, you can use a workflow that interfaces with the macOS Messages.app via the imsg CLI tool, requiring user confirmation before delivering text or attachments to contacts.

Can I retrieve chat history from Messages.app on macOS?

Yes, you can retrieve chat history from Messages.app on macOS by using a command-line workflow that reads and monitors conversation activity directly through the macOS Messages.app interface.

Does sending SMS messages through macOS require user confirmation?

Yes, sending SMS messages through macOS requires user confirmation to safeguard the workflow, ensuring you verify the recipient and message content before the imsg CLI tool executes the delivery.

What do I need to automate messaging on Apple devices?

To automate messaging on Apple devices, you need a Mac with macOS Messages.app access, the imsg CLI tool installed, and the necessary Full Disk Access permissions for the command-line interface to interact with your conversations.

Are there limitations to managing SMS conversations through a Mac CLI?

Managing SMS conversations through a Mac CLI is limited to macOS environments, as the workflow depends entirely on the local Messages.app and the imsg CLI tool to send texts, retrieve chat history, and deliver attachments.