imsg

List, fetch, watch, and send iMessage or SMS messages from the macOS command line.

55|6|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/NJX-njx/opensoul --skill imsg-njx-njx
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/NJX-njx/opensoul/tree/main/skills/imsg
Command: npx skills add https://github.com/NJX-njx/opensoul --skill imsg-njx-njx

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill enables users to read, watch, and send messages on iMessage/SMS via command line, streamlining communication management.

Core Features & Use Cases

  • Listing chats: View recent conversation identifiers for quick access.
  • Fetching chat history: Retrieve past messages and attachments for specific chats.
  • Watching chats: Stream incoming messages in real-time to monitor ongoing conversations.
  • Sending messages: Compose and send messages to recipients directly from the terminal, integrating with messaging workflows.
  • Use Case: Imagine needing to monitor multiple SMS conversations during a project; this Skill allows watching a chat to stay updated without switching apps, or sending quick messages directly from terminal scripts.

Quick Start

Use the imsg skill to list your latest chats, then fetch history or send messages as needed.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send and receive iMessage texts from the terminal on macOS?

You can send and receive iMessage texts from the terminal by using a command-line interface that connects directly to the Messages.app. This allows you to list chats, fetch history, watch ongoing conversations in real-time, and send messages without switching applications.

Can I monitor ongoing SMS conversations in real-time via command line?

Yes, you can monitor ongoing SMS conversations in real-time via command line. The interface provides a watching feature that streams incoming messages directly to your terminal, enabling you to track multiple chats simultaneously during a project.

What permissions do I need to manage iMessage chats from the command line?

To manage iMessage chats from the command line, you need to grant full disk access and automation permissions to the interface on your macOS system. These permissions are required to interact with the Messages.app database and send messages.

How do I retrieve chat history and attachments for a specific SMS conversation?

You retrieve chat history and attachments for a specific SMS conversation by listing recent chats to find the identifier, then fetching the history for that specific chat. This extracts past messages and their associated files directly to your terminal.

Does this command line messaging tool work on operating systems other than macOS?

No, this command line messaging tool does not work on operating systems other than macOS. It interfaces directly with the Messages.app and depends on macOS-specific binaries to manage iMessage and SMS communications.

How do I automate sending SMS messages through a shell script?

You automate sending SMS messages through a shell script by calling the command-line messaging binary within your script. This integrates message sending directly into your terminal workflows, allowing you to compose and dispatch texts programmatically.