imsg

Send and receive iMessage and SMS via macOS Messages.app command-line interface.

2|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/FatBy/DD-OS --skill imsg-fatby
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/FatBy/DD-OS/tree/main/skills/imsg
Command: npx skills add https://github.com/FatBy/DD-OS --skill imsg-fatby

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes 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 messages, view chat history, and manage your communications efficiently.

Core Features & Use Cases

  • Send Messages: Compose and send iMessages or SMS to specific contacts.
  • View Chat History: Retrieve past messages from any chat, with options for attachments.
  • List Chats: Get a list of your recent conversations.
  • Use Case: Quickly send a text to a contact without opening the Messages app, or review a past conversation to recall details.

Quick Start

Use the imsg skill to send a text message to John Doe saying "I'll be there soon".

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessages from the command line on macOS?▼

You can send iMessages from the command line by using this Skill to interact directly with macOS Messages.app, specifying the recipient and text. It requires macOS with Messages.app signed in and appropriate terminal permissions.

Can I retrieve iMessage chat history and attachments via terminal?▼

Yes, you can retrieve iMessage chat history and attachments via terminal. This Skill interfaces with macOS Messages.app to view past messages and list recent conversations directly from your command line interface.

Do I need Messages.app signed in to send SMS from a CLI?▼

Yes, you need Messages.app signed in to send SMS from a CLI. This Skill acts as a bridge to the macOS Messages.app, requiring both active sign-in and proper terminal permissions to send and receive texts.

What is the best way to read text messages without opening the Messages app?▼

The best way to read text messages without opening the Messages app is using a CLI Skill like this one. It queries macOS Messages.app to list chats and view message history with attachments directly in your terminal.

Does this CLI messaging tool support listing recent iMessage conversations?▼

Yes, this CLI messaging tool supports listing recent iMessage conversations. It retrieves your recent chats from macOS Messages.app, allowing you to review past conversations and select recipients directly from the terminal.