imsg

Send and receive iMessage and SMS messages via macOS command line.

3|1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/gensparx/GenSparx --skill imsg-gensparx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/gensparx/GenSparx/tree/main/skills/imsg
Command: npx skills add https://github.com/gensparx/GenSparx --skill imsg-gensparx

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to interact with your iMessage and SMS conversations directly from the command line, enabling you to send and receive messages without needing to open the Messages.app.

Core Features & Use Cases

  • Send Messages: Compose and send iMessages or SMS to contacts using their phone numbers or Apple IDs.
  • View History: Retrieve past conversation history for specific chats, including attachments.
  • List Chats: Get a list of your recent iMessage/SMS conversations.
  • Watch for New Messages: Monitor a specific chat for incoming messages.
  • Use Case: You can ask the assistant to "Text John that I'm running 10 minutes late" and it will use this skill to send the iMessage.

Quick Start

Use the imsg skill to send a message to +1234567890 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 texts from the command line on macOS?

You can send iMessage or SMS texts from the command line on macOS by using a CLI skill that interfaces with the Messages.app, requiring the app to be signed in and configured for automation to deliver messages to specified recipients.

Can I retrieve iMessage conversation history and attachments via terminal?

Yes, you can retrieve iMessage conversation history and attachments via terminal by executing specific CLI commands that list recent chats and extract past message records along with their associated media files from Messages.app.

What do I need to automate SMS messaging through a macOS CLI?

To automate SMS messaging through a macOS CLI, you need the Messages.app actively signed in and configured for automation, enabling the command-line interface to access your chats and dispatch texts without opening the graphical application.

How does a command-line interface monitor incoming iMessages?

A command-line interface monitors incoming iMessages by watching a specific chat for new messages, allowing you to track real-time conversation updates directly within your terminal environment instead of the Messages.app.

Are there limitations to sending iMessages using a CLI on macOS?

Limitations of sending iMessages using a CLI on macOS include strict dependency on the Messages.app being actively signed in and configured for automation, meaning the skill cannot operate independently without this native macOS environment setup.