imsg

Read and send iMessage/SMS from macOS Messages.app via CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and send iMessage/SMS from macOS Messages.app via the command line, enabling automation and scripting of everyday messaging tasks.

Core Features & Use Cases

  • List chats and view conversation history from the terminal.
  • Send text messages to phone numbers or Apple IDs using Messages.app.
  • Watch for new messages and integrate with scripts for automated workflows.

Quick Start

Send a text to a contact via Messages.app from the terminal using imsg.

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 a terminal command line?

To send iMessage or SMS from a terminal command line, you can use a CLI tool to programmatically dispatch messages to contacts or Apple IDs via macOS Messages.app. This enables direct text sending from scripts.

Can I read and audit chat history from Messages.app in the CLI?

You can read and audit chat history from Messages.app in the CLI by listing active chats and viewing conversation history directly in the terminal. This provides a text-based interface for reviewing past interactions.

How do I automate sending text messages on macOS?

You can automate sending text messages on macOS by integrating CLI commands into your scripts to watch for new messages and dispatch texts automatically. This requires Messages.app to be signed in.

Do I need specific permissions to control Messages.app via the command line?

Yes, you need macOS with Messages.app signed in and explicit automation permissions granted for programmatic access. These permissions allow the CLI to read chats and dispatch messages on your behalf.

What is the best way to script iMessage workflows for automated conversations?

The best way to script iMessage workflows for automated conversations is using a CLI that interfaces with macOS Messages.app to watch for new messages and execute scripted responses. This supports complex automated messaging pipelines.

Why does my CLI fail to send iMessage from a script?

Your CLI fails to send iMessage from a script if macOS Messages.app is not signed in or lacks automation permissions for programmatic access. Ensure the application is active and authorized to control messaging.