imessage

Read and send iMessage conversations via the imsg CLI on macOS.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/ChimeraFoundationa/Agentx --skill imessage-chimerafoundationa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ChimeraFoundationa/Agentx/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/ChimeraFoundationa/Agentx --skill imessage-chimerafoundationa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate reading iMessage conversations and sending messages from the macOS Messages app using the imsg CLI, eliminating the need to switch apps for quick communications.

Core Features & Use Cases

  • Read chats and conversation history from Messages.app
  • Send iMessage or SMS to contacts with optional attachments
  • View and manage recent threads from the command line
  • Respect safety prompts and require user confirmation before sending

Quick Start

Install and run imsg on macOS to start reading and sending iMessages from the command line.

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 command line on macOS?

You can send iMessages from the command line by using the imsg CLI on macOS to automate the Messages app. This allows you to dispatch messages directly from your terminal without switching applications.

Can I read iMessage conversation history using a CLI tool?

Yes, you can read iMessage conversation history using the imsg CLI tool. It automates listing chats and viewing past message threads directly from the macOS Messages app within your terminal.

Do I need macOS to use the imsg CLI for SMS and iMessage automation?

Yes, you need macOS to use the imsg CLI for SMS and iMessage automation. The tool requires direct access to the macOS Messages app to read chats and send messages successfully.

Can I attach files when sending iMessages from the terminal?

Yes, you can attach files when sending iMessages from the terminal. The imsg CLI supports optional attachments, validating file paths to ensure files are correctly sent alongside your messages.

Are there safety prompts when automating SMS sending from the command line?

Yes, there are safety prompts when automating SMS sending from the command line. The imsg CLI enforces explicit recipient confirmation rules before sending any messages to prevent accidental dispatch.