skills.rest
openaeon
openaeonCOMMUNITY
Explore all skills by this author →
GitHub

imsg

List Messages.app chats, read history, and send iMessage or SMS via macOS CLI.

87|20|Updated Mar 9, 2026
Search Tags:#cli#chat history#macos automation#sms#imessage#messages.app#attachment sending
One-click install
npx skills add https://github.com/openaeon/OpenAEON --skill imsg-openaeon
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/openaeon/OpenAEON/tree/main/skills/imsg
Command: npx skills add https://github.com/openaeon/OpenAEON --skill imsg-openaeon

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes friction from manually searching Messages.app by letting you list chats, inspect history, and send iMessage/SMS directly from the command line on macOS.

Core Features & Use Cases

  • Chat discovery & listing: Find the right conversation by listing recent Messages.app chats.
  • History viewing: Read past messages for a specific chat ID, including optional attachment details.
  • Sending messages: Deliver text and optional attachments via Messages.app, with explicit service control for iMessage vs SMS.
  • Use Case: You need to quickly locate a past thread with someone and send a follow-up with an image attachment without opening Messages manually.

Quick Start

Ask your AI to list your recent Messages.app chats using imsg so you can choose the correct chat to reply or send a message.

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

You can send iMessage or SMS from the macOS command line by using the imsg binary to interact with Messages.app, specifying a phone number or Apple ID along with your text and optional attachments.

Can I read Messages.app chat history from the CLI on macOS?▼

Yes, you can read Messages.app chat history from the CLI by listing recent chats to find a specific chat ID, then retrieving past messages and optional attachment details for that conversation.

What permissions do I need to automate sending text messages via Messages.app?▼

To automate sending text messages via Messages.app, you need Automation and Full Disk Access permissions granted to your CLI tool, the imsg binary installed, and Messages.app actively signed in.

How do I find a specific conversation thread in Messages.app without opening the app?▼

You can find a specific conversation thread without opening the app by triggering the imsg CLI to list recent Messages.app chats, allowing you to locate the correct chat ID for follow-up actions.

Can I send image attachments via iMessage using a macOS CLI workflow?▼

Yes, you can send image attachments via iMessage using a macOS CLI workflow by passing the attachment file to the imsg binary, which delivers it through Messages.app with explicit service control.

Why is my macOS automation script failing to read chat history from Messages.app?▼

Your macOS automation script fails to read chat history when Full Disk Access permissions are not granted to the executing environment, preventing the imsg binary from reliably interacting with Messages.app data.

Related Skills

Explore More Content & Communication Skills→
TitoPrauseeTitoPrausee

imessage

Send and read iMessages and SMS via macOS Messages.app using imsg CLI.

Community
Intermediate
steipetesteipete
385.7k

imsg

Read and send iMessage/SMS conversations on macOS via a CLI tool.

Community
Intermediate
UselessXuUselessXu

imsg

Automate iMessage and SMS tasks from the macOS terminal.

Community
Intermediate
moltis-orgmoltis-org
2.8k

imessage

Read and send iMessages and SMS via the imsg CLI on macOS.

Official
Intermediate