imsg

Send SMS or iMessage texts and read macOS Messages.app conversation history.

Updated Jun 18, 2026
One-click install
npx skills add https://github.com/wangqianCAI/OBI --skill imsg-wangqiancai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/wangqianCAI/OBI/tree/main/skills/imsg
Command: npx skills add https://github.com/wangqianCAI/OBI --skill imsg-wangqiancai

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your terminal and macOS Messages.app, allowing you to programmatically interact with your messaging history and send texts without leaving your command-line environment.

Core Features & Use Cases

  • Message Retrieval: List recent chats and view detailed conversation history with support for attachments.
  • Automated Messaging: Send text messages or files to specific contacts via iMessage or SMS.
  • Real-time Monitoring: Watch for incoming messages in specific conversations to trigger automated workflows.
  • Use Case: Integrate your messaging workflow with other CLI tools to notify yourself of task completions or to quickly send status updates to team members.

Quick Start

Use the imsg skill to send a text message to the phone number 14155551212 saying that you will be late for the meeting.

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 from the command line by using this skill to programmatically access macOS Messages.app. It enables dispatching texts and files to contacts directly without leaving your terminal environment.

Can I retrieve and analyze chat history from Messages.app using a CLI tool?

Yes, you can retrieve chat history from Messages.app using this CLI tool to list recent chats and view detailed conversations. It supports reading text logs and attachments for programmatic chat log analysis.

What macOS permissions are required to automate text messaging via terminal?

Automating text messaging via terminal requires a macOS environment with Full Disk Access and Automation permissions granted to your terminal. These permissions are necessary for the CLI to interact with Messages.app.

How do I monitor incoming iMessage texts to trigger automated workflows?

You can monitor incoming iMessage texts by using the real-time monitoring feature to watch for new messages in specific conversations. This allows you to trigger automated workflows when incoming messages are detected.

What is the best way to send automated task completion notifications via iMessage?

The best way to send automated task completion notifications via iMessage is by integrating this CLI messaging tool with your existing scripts. It dispatches messages to your phone number upon task completion.

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

No, this CLI messaging tool does not work on other operating systems because it requires macOS Messages.app to function. It is strictly limited to macOS environments due to its dependency on the native messaging application.