skills.rest
Luzzer
LuzzerCOMMUNITY
Explore all skills by this author →
GitHub

imsg

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

Updated Apr 7, 2026
Search Tags:#automation#cli#macos#sms#imessage#chat-history#messages.app
One-click install
npx skills add https://github.com/Luzzer/Kraken --skill imsg-luzzer
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Luzzer/Kraken/tree/main/skills/imsg
Command: npx skills add https://github.com/Luzzer/Kraken --skill imsg-luzzer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage and SMS interactions on macOS are traditionally GUI-only; this Skill enables listing chats, viewing history, and sending messages via a lightweight command-line interface.

Core Features & Use Cases

  • List chats and recent conversations from Messages.app.
  • View message history for a chat and optionally search within it.
  • Send text messages to phone numbers or Apple IDs through the built-in Messages.app.
  • Automate simple messaging workflows from scripts or tools.

Quick Start

Use imsg to list chats and send a message to a contact via the macOS Messages.app.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send an iMessage from the command line on macOS?▼

You can send an iMessage from the macOS command line by using a CLI tool to route text messages through the built-in Messages.app to a phone number or Apple ID. The binary uses CLI flags to specify recipients.

Can I view iMessage chat history in the terminal?▼

Yes, you can view iMessage chat history in the terminal by listing chats and reading recent conversations. The CLI tool also supports searching within the message history of a specific chat.

What are the requirements for automating SMS workflows on macOS?▼

Automating SMS workflows on macOS requires the macOS operating system, a signed-in Messages.app, and a runnable CLI binary. User confirmation prompts ensure safe execution during automated messaging tasks.

How do I list recent conversations from Messages.app in a script?▼

To list recent conversations from Messages.app in a script, execute the CLI binary to output available chats. This enables automated workflows to parse and interact with message history directly.

Does the iMessage CLI tool support sending messages to Apple IDs?▼

Yes, the iMessage CLI tool supports sending messages to Apple IDs as well as phone numbers. It leverages the built-in Messages.app to deliver texts to any valid Apple contact identifier.

Related Skills

Explore More Software Engineering Skills→
adamhjoujadamhjouj
4

imsg

Read and send iMessage/SMS via macOS Messages.app from a CLI.

Community
Intermediate
ai-in-pmai-in-pm
3

wacli

Automate WhatsApp messaging and history management via the wacli CLI.

Community
Intermediate
89jobrien89jobrien
4

shell-scripting

Automate administrative tasks with portable bash/zsh scripts and strict error handling.

Community
Intermediate
lengoctuong2005lengoctuong2005
5

imessage

Send and receive iMessages/SMS via the imsg CLI in macOS Messages.app.

Community
Basic