imessage

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

1|Updated Apr 30, 2025
One-click install
npx skills add https://github.com/lucasfth/config --skill imessage-lucasfth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/lucasfth/config/tree/main/.hermes/skills/apple/imessage
Command: npx skills add https://github.com/lucasfth/config --skill imessage-lucasfth

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables macOS users to interact with Messages.app from the command line, allowing sending and reading iMessages/SMS without opening the GUI.

Core Features & Use Cases

  • List chats to identify conversations without opening Messages.app.
  • View chat history and attachments to review recent messages quickly.
  • Send text messages or attachments to contacts or Apple IDs from the command line.
  • Watch for new messages and respond in real time, enabling automation workflows.
  • Apply service options and usage guidelines to ensure safe and deliberate messaging.

Quick Start

Use imsg to send an iMessage to a contact after selecting the recipient from chats.

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?

To send iMessages from the macOS command line, use the imsg CLI to send text messages or attachments to contacts or Apple IDs. This requires macOS with Messages.app signed in and imsg installed via Homebrew.

Can I read iMessage chat history without opening the Messages app?

Yes, you can read iMessage chat history without opening the Messages app by using the imsg CLI. It allows you to list chats, view recent chat history, and access attachments directly from the macOS command line.

How do I watch for new iMessages to trigger automation scripts on macOS?

You can watch for new iMessages to trigger automation scripts on macOS by using the imsg CLI. It supports real-time monitoring of incoming messages, enabling automated response workflows without opening the Messages.app GUI.

What are the requirements for using imsg to automate messaging on macOS?

The requirements for using imsg to automate messaging on macOS include having macOS with Messages.app signed in, installing the imsg CLI tool via Homebrew, and granting the necessary system permissions for command-line access.

Does the imsg CLI support sending attachments to Apple IDs?

Yes, the imsg CLI supports sending attachments to Apple IDs. You can send files and text messages to specific contacts directly from the macOS command line without needing to open the Messages.app interface.