imsg

Read and send iMessage/SMS conversations from the macOS command line.

Updated Apr 24, 2026
One-click install
npx skills add https://github.com/frankhli843/gemmahermes --skill imsg-frankhli843
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/frankhli843/gemmahermes/tree/main/skills/imsg
Command: npx skills add https://github.com/frankhli843/gemmahermes --skill imsg-frankhli843

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading and sending iMessage/SMS from the command line via macOS Messages.app, streamlining messaging workflows without needing to open the Messages app.

Core Features & Use Cases

  • List chats and view history in Messages.app to stay on top of conversations.
  • Send messages to iMessage contacts or phone numbers directly from the terminal.
  • Watch for new messages or pull recent conversations to keep context in automation.

Quick Start

List chats with imsg chats and send a message with imsg send to a chosen contact.

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

You can send iMessage or SMS from the command line by using terminal commands that interface directly with the macOS Messages.app. This allows you to send messages to phone numbers or contacts without opening the Messages app.

Can I list and view my iMessage chat history in the terminal?

Yes, you can list active chats and view conversation history directly in the terminal. This functionality queries Messages.app to retrieve and display your recent chats and message logs within your command line interface.

Do I need to keep the Messages app open to automate sending iMessages via CLI?

No, you do not need to manually open the Messages app. The CLI automation interacts with Messages.app in the background to read and send texts, streamlining your messaging workflows directly from the terminal.

What is the best way to automate personal messaging workflows on macOS?

Automating personal messaging workflows is best achieved through macOS CLI automation tools that control Messages.app. This approach enables listing chats, viewing history, and sending messages programmatically without manual app interaction.

How do I watch for new iMessages or pull recent conversations for automation?

You can watch for new messages or pull recent conversations by executing specific terminal commands that query Messages.app. This retrieves the latest message data to maintain context within your automated macOS workflows.

Are there limitations to controlling SMS and iMessage conversations from a terminal?

This approach is limited to personal messaging workflows on macOS and requires Messages.app prerequisites. It is designed for listing chats, viewing history, and sending messages, and may not support advanced app features like message reactions.