imsg

Send iMessage and SMS messages via macOS Messages.app from the command line.

1.0k|59|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SafeAI-Lab-X/ClawKeeper --skill imsg-safeai-lab-x
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/SafeAI-Lab-X/ClawKeeper/tree/main/legacy/clawkeeper-watcher/skills/imsg
Command: npx skills add https://github.com/SafeAI-Lab-X/ClawKeeper --skill imsg-safeai-lab-x

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS CLI for listing chats, history, and sending messages via macOS Messages.app.

Core Features & Use Cases

  • List chats and view recent conversations from the terminal.
  • Send messages to phone numbers or Apple IDs, with optional service selection (iMessage or SMS).
  • View conversation history and manage simple message workflows from scripts or automation.

Quick Start

Install imsg via Homebrew and begin sending messages through Messages.app from the command line.

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 using the imsg CLI, which interfaces directly with macOS Messages.app to dispatch messages to phone numbers or Apple IDs.

Can I list chats and view conversation history in Messages.app via terminal?

Yes, listing chats and viewing recent conversation history in Messages.app via the terminal is possible by running the imsg CLI tool on your local macOS environment.

Do I need Homebrew to install the iMessage command line interface?

Yes, installing the iMessage CLI requires Homebrew to set up the tool, and you must have macOS Messages.app signed in with appropriate automation permissions enabled.

How do I select between iMessage and SMS when sending a message from the terminal?

When sending a message from the terminal, you can apply optional service selection within the imsg CLI to specify whether it routes through iMessage or SMS.

What are the limitations of using a CLI for iMessage workflows?

Limitations include strict dependency on a local macOS environment with Messages.app actively signed in, requiring explicit automation permissions for any script or automated workflow execution.