imessage

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

Updated Mar 24, 2026
One-click install
npx skills add https://github.com/1thirteeng3/greenmoire --skill imessage-1thirteeng3
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/1thirteeng3/greenmoire/tree/main/integrations/hermes-agent/skills/apple/imessage
Command: npx skills add https://github.com/1thirteeng3/greenmoire --skill imessage-1thirteeng3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enables sending and reading iMessages and SMS from macOS using the imsg CLI, reducing manual switching between apps and streamlining messaging workflows.

Core Features & Use Cases

  • Read chat history and list chats from Messages.app
  • Send text messages and attachments to phone numbers or Apple IDs
  • Watch for new messages and manage conversations from the command line

Quick Start

Install imsg via Homebrew, ensure Messages.app is signed in, and start by listing chats or sending a message.

Frequently Asked Questions about imessage

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

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

You can send and receive iMessages from the macOS command line by using the imsg CLI. It facilitates composing messages, viewing chat history, and monitoring new messages directly from your terminal.

What are the prerequisites for automating SMS and iMessage workflows on macOS?

Automating SMS and iMessage workflows on macOS requires the imsg command installed via Homebrew. You must also have Messages.app signed in with proper permissions granted to the CLI.

Can I view chat history and list conversations from Messages.app in the terminal?

Yes, you can view chat history and list conversations from Messages.app in the terminal. The imsg CLI reads your local message database to display existing chats and monitor incoming texts.

How do I send attachments to Apple IDs or phone numbers via the imsg CLI?

To send attachments to Apple IDs or phone numbers via the imsg CLI, use the appropriate command arguments. The tool supports sending text messages and attachments directly to your contacts.

How can I watch for new messages and manage conversations from the command line?

You can watch for new messages and manage conversations from the command line using the imsg CLI's monitoring features. It enables automated tracking of incoming iMessages and SMS texts.