imsg

Send iMessages and SMS, list chats, and retrieve history via command line.

Updated Mar 10, 2026
One-click install
npx skills add https://github.com/lemonlqf/openclaw-rtsp --skill imsg-lemonlqf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/lemonlqf/openclaw-rtsp/tree/main/skills/imsg
Command: npx skills add https://github.com/lemonlqf/openclaw-rtsp --skill imsg-lemonlqf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) and 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 view chat history without needing to open the Messages.app.

Core Features & Use Cases

  • Send iMessages/SMS: Compose and send text messages, optionally with attachments, to specific contacts or phone numbers.
  • List Chats: Retrieve a list of recent iMessage/SMS conversations.
  • View History: Access past messages within a specific chat, with options to include attachment information.
  • Watch for New Messages: Monitor a specific chat for incoming messages in real-time.
  • Use Case: Quickly send a text to a contact about your ETA or check your recent message history without leaving your terminal.

Quick Start

Use the imsg skill to send a text message to your mom.

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?

To send iMessage or SMS from the command line on macOS, you can use this skill to compose and send text messages to contacts, optionally including attachments. It requires the Messages.app to be signed in and configured for automation.

Can I retrieve iMessage chat history and list recent conversations via CLI?

Yes, you can retrieve iMessage chat history and list recent conversations via CLI. The skill allows you to list recent chats, view past messages within specific conversations, and include attachment information in the output.

Does sending iMessages through the terminal require any specific macOS configuration?

Sending iMessages through the terminal requires macOS with the Messages.app signed in and configured for automation. The skill utilizes the 'imsg' binary to manage these interactions directly from your command line.

How do I select between iMessage and SMS when sending a text via CLI?

You can select between iMessage and SMS when sending a text via CLI by using the service selection options provided by the skill. It supports iMessage, SMS, and an auto-detect mode to route your message appropriately.

Can I monitor specific iMessage chats for incoming messages in real-time?

Yes, you can monitor specific iMessage chats for incoming messages in real-time. The skill features a watch mode that monitors a specific chat for incoming messages directly within your terminal environment.

What are the limitations of using a CLI for iMessage and SMS communication?

A limitation of using a CLI for iMessage and SMS communication is that it strictly requires macOS and an active, automated Messages.app configuration. It relies entirely on the 'imsg' binary for all messaging operations and attachment handling.