skills.rest
Kastalien-Research
Kastalien-ResearchOFFICIAL
Explore all skills by this author →
WebsiteGitHub

imsg

List chats, fetch history, and send messages via the imsg CLI.

Updated Mar 23, 2026
Search Tags:#automation#cli#macos#chat#messages#sms#imsg
One-click install
npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill imsg-kastalien-research
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Kastalien-Research/kastalien-factory/tree/main/lettabot/.skills/imsg
Command: npx skills add https://github.com/Kastalien-Research/kastalien-factory --skill imsg-kastalien-research

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS Messages is powerful but interacting via the GUI complicates quick automations. imsg provides a terminal interface to list chats, fetch history, watch for updates, and send messages straight from the command line.

Core Features & Use Cases

  • List chats and fetch history with JSON output.
  • Real-time watch of chat activity and updates.
  • Send messages to contacts or numbers with optional attachments.
  • Requires Messages.app sign-in and necessary automation permissions to control Messages.app.

Quick Start

Begin by listing your chats and then send a message to a contact using the imsg CLI.

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 terminal?▼

You can send iMessage or SMS from the macOS terminal by using the imsg CLI, which provides a command-line interface to send messages to contacts or numbers with optional attachments. It requires Messages.app sign-in and Terminal Automation permissions.

Can I list and view macOS Messages chat history in JSON?▼

Yes, you can list chats and fetch chat history with JSON output directly in your terminal. The imsg tool provides native macOS Messages.app integration, allowing you to easily retrieve conversation data for automation workflows.

What's the best way to automate macOS Messages communication workflows?▼

Automating macOS Messages communication workflows is best handled through a CLI tool like imsg, which allows developers and power users to list chats, watch real-time activity, and send batch messages straight from the command line.

Does the imsg CLI require Messages.app to be signed in to work?▼

Yes, the imsg CLI requires Messages.app to be signed in and needs Terminal Automation permission to function. It uses native Messages.app integration via the imsg binary to control conversations from your terminal.

Are there limitations to controlling iMessage from the command line?▼

Controlling iMessage from the command line is limited to macOS environments with Messages.app signed in and proper automation permissions granted. It is specifically designed for macOS and cannot be used on other operating systems.

Related Skills

Explore More Software Engineering Skills→
webdevtodayjasonwebdevtodayjason

imessage

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

Community
Basic
psd401psd401
2

scope

Classify work scope into Small, Medium, or Large and route execution paths.

Official
Advanced
rnbenrnben

imessage

Read and send iMessages and SMS from the macOS command line via imsg.

Community
Intermediate
agentic-inagentic-in
577

iMessage

Read Messages.app conversations and send messages via CLI or AppleScript with confirmation.

Official
Intermediate