imsg

Manage iMessage and SMS chats, history, and messages via command line.

Updated Jan 20, 2026
One-click install
npx skills add https://github.com/Team-Hireal/RealChat --skill imsg-team-hireal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Team-Hireal/RealChat/tree/main/openclaw/skills/imsg
Command: npx skills add https://github.com/Team-Hireal/RealChat --skill imsg-team-hireal

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a command-line interface for interacting with iMessage and SMS on macOS, allowing users to manage chats, view history, and send messages without leaving their terminal.

Core Features & Use Cases

  • List Chats: View recent iMessage/SMS conversations.
  • Fetch History: Retrieve message history for specific chats, including attachments.
  • Send Messages: Compose and send text messages and multimedia messages.
  • Watch Chats: Stream incoming messages in real-time.
  • Use Case: Quickly send a photo to a contact or check your latest messages from a specific chat without opening the Messages application.

Quick Start

Use the imsg skill to send a message with the text "Hello from the command line" to the recipient "+14155551212".

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

You can send iMessage or SMS from the macOS command line by using this Skill to compose and dispatch text messages and files directly to recipients without opening the Messages application.

Can I retrieve iMessage chat history and attachments via CLI?

Yes, you can retrieve iMessage chat history and attachments via CLI. This Skill fetches full message histories for specific conversations, including any associated multimedia attachments, directly in the terminal.

How do I monitor iMessage conversations in real time on macOS?

To monitor iMessage conversations in real time on macOS, this Skill provides a watch feature that streams incoming messages directly to your terminal for live chat monitoring.

Do I need to install a separate binary to manage iMessage from the terminal?

Yes, you need a separate binary. This Skill requires the 'imsg' binary to be installed and properly configured for terminal access to the Messages.app database and messaging capabilities on macOS.

What is the best way to automate SMS messaging on macOS?

The best way to automate SMS messaging on macOS is using this CLI Skill, which allows scripts to list chats, fetch histories, and programmatically send text or multimedia messages without manual GUI interaction.