imsg

Send iMessage and SMS messages with attachments via macOS command line.

3|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/ybsa/sovereign-kernel --skill imsg-ybsa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/ybsa/sovereign-kernel/tree/main/crates/sk-tools/skills/imsg
Command: npx skills add https://github.com/ybsa/sovereign-kernel --skill imsg-ybsa

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to interact with their iMessage and SMS conversations directly from the command line, enabling them to send messages and retrieve chat history without needing to open the Messages.app.

Core Features & Use Cases

  • Send iMessage/SMS: Compose and send text messages or messages with attachments to phone numbers or Apple IDs.
  • List Chats: View a list of recent iMessage/SMS conversations.
  • View History: Retrieve the message history for a specific chat.
  • Watch for New Messages: Monitor a chat for incoming messages.
  • Use Case: A user wants to quickly send a text message to a contact to confirm an appointment.

Quick Start

Use the imsg skill to send a text message to +14155551212 with the text "Hello!".

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 from the command line on macOS?

You can send iMessage or SMS from the command line on macOS using the imsg binary, which composes and dispatches text messages or attachments directly to phone numbers or Apple IDs without opening the Messages app.

Can I retrieve iMessage chat history via the terminal?

Yes, you can retrieve iMessage chat history via the terminal by listing recent conversations and pulling the specific message history for a selected chat using the imsg command-line interface.

Do I need to install any specific binaries to manage SMS through the macOS terminal?

Yes, managing SMS through the macOS terminal requires the imsg binary to be installed and properly configured to interact with the native Messages.app before you can send texts or view chat logs.

Is it possible to monitor incoming iMessage conversations in real-time using a CLI?

Yes, it is possible to monitor incoming iMessage conversations in real-time using a CLI by utilizing the watch feature to observe a specific chat for new incoming messages.

What is the best way to send text messages with attachments from the macOS command line?

The best way to send text messages with attachments from the macOS command line is using the imsg tool, which facilitates composing messages with files and sending them to contacts via the native Messages application.

Why use a command line interface for iMessage instead of the native Messages app?

Using a command line interface for iMessage allows users to quickly send texts, view chat histories, and monitor new messages programmatically, enabling seamless automation without needing to manually open the Messages app.