imsg

Send iMessage and SMS messages with attachments via macOS command line.

Updated Feb 1, 2026

Search Tags:#messaging #cli #macos #sms #imessage

Ready to run

npx skills add https://github.com/NJUxlj/openclaw --skill imsg-njuxlj

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/NJUxlj/openclaw/tree/main/skills/imsg
Command: npx skills add https://github.com/NJUxlj/openclaw --skill imsg-njuxlj

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 messages and view chat history without leaving your terminal.

Core Features & Use Cases

Send iMessages and SMS: Compose and send text messages and messages with attachments to phone numbers or Apple IDs.
List Chats: View a list of your recent iMessage/SMS conversations.
View Message History: Retrieve past messages within a specific chat.
Watch for New Messages: Monitor a chat for incoming messages.

Quick Start

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

You can send iMessage or SMS directly from the macOS terminal by using this skill to compose messages with text and attachments for phone numbers or Apple IDs. It interfaces with the Messages app for delivery.

Can I view my iMessage chat history in the terminal?▼

Yes, you can retrieve and view your iMessage chat history in the terminal. This skill lists your recent active chats and retrieves past conversation messages for specific contacts directly within the command line interface.

Do I need to grant terminal permissions to automate SMS messaging on macOS?▼

Yes, automating SMS messaging requires macOS with Messages.app signed in and appropriate terminal permissions for automation. You must grant the necessary accessibility controls to allow the command line to interact with your messages.

What is the best way to monitor an iMessage chat for new incoming messages?▼

The best way to monitor an iMessage chat for new messages is to use the watch feature. This skill facilitates watching active chats for incoming messages, alerting you to new texts directly from the command line.

Does this command line messaging tool support sending attachments?▼

Yes, this command line messaging tool supports sending attachments. You can compose and send messages that include both text and file attachments to phone numbers or Apple IDs through the iMessage and SMS protocols.

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

Limitations of using a CLI for iMessage communication include requiring macOS with Messages.app signed in and specific terminal permissions. It is bound by the native app's capabilities and cannot operate independently of the macOS environment.