imessage

Send and read iMessages and SMS via the imsg CLI on macOS.

1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill imessage-changzhou-xj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ChangZhou-xj/zxj_skill/tree/main/apple/imessage
Command: npx skills add https://github.com/ChangZhou-xj/zxj_skill --skill imessage-changzhou-xj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate sending and reading iMessages and SMS via the imsg CLI on macOS, enabling messaging automation from scripts and workflows.

Core Features & Use Cases

  • Send messages to iMessage or SMS from the terminal.
  • Read history and list chats to review recent conversations.
  • Watch for new messages to trigger actions on new events.
  • Example: Use it to notify yourself of important messages and respond without leaving the terminal.

Quick Start

Install imsg with Brew and start sending or reading iMessages from the terminal.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages from the macOS command line?

You can send iMessages from the macOS command line by using the imsg CLI to automate the Messages app, enabling scripted text outputs without leaving the terminal.

Can I read iMessage chat history using a CLI on macOS?

Yes, you can read iMessage chat history by running the imsg CLI to list chats and view recent conversation histories directly within your macOS terminal workflows.

Do I need the Messages app signed in to automate SMS with the imsg CLI?

Yes, automating SMS and iMessage requires macOS with the Messages app actively signed in, the imsg CLI installed, and proper permissions granted to access Messages.app.

How do I watch for new iMessages to trigger automated scripts?

You can watch for new iMessages by utilizing the imsg CLI's watch feature, which monitors incoming texts and triggers automated actions or notifications for new events.

What are the limitations of using a command-line tool for iMessage automation?

iMessage automation via the command line is limited to macOS environments with Messages.app configured, meaning it cannot operate on non-Apple platforms or without proper system permissions.