skills.rest
BEIRUX
BEIRUXOFFICIAL
Explore all skills by this author →
GitHub

imsg

Read iMessage and SMS conversations and send messages via macOS Messages.app.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables developers or power users to interact with iMessage/SMS via the macOS Messages.app, allowing reading chat history, listing recent conversations, and sending messages without opening the GUI.

Core Features & Use Cases

  • Read iMessage and SMS conversations from the terminal to stay informed without switching apps.
  • List recent chats and fetch message history for any conversation.
  • Send a message to a contact or Apple ID with pre-send confirmation to prevent errors in sensitive communications.

Quick Start

Read the latest chat with a contact and send a message using a single command.

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

To send an iMessage from the macOS terminal, use the imsg CLI to compose messages to contacts or Apple IDs via Messages.app. It includes a pre-send confirmation step to prevent errors in sensitive communications.

Can I read iMessage chat history from the command line?▼

Yes, you can read iMessage chat history from the command line using the imsg tool. It fetches conversation history and lists recent chats from macOS Messages.app without needing to open the GUI.

What do I need to use a CLI to read and send SMS on macOS?▼

To use a CLI for SMS on macOS, you need a Mac with Messages.app configured, terminal access, automation permissions granted, and the imsg binary installed via a package manager like brew.

Does sending iMessages via terminal automation require GUI interaction?▼

Sending iMessages via terminal automation does not require GUI interaction for reading chats, but the imsg binary utilizes macOS Messages.app in the background to send SMS and requires initial automation permissions.

Are there limitations when sending SMS through the macOS command line?▼

When sending SMS through the macOS command line, you are limited by your existing Messages.app configuration and contacts. The imsg tool requires explicit pre-send confirmation to prevent sending messages to incorrect recipients.

What is the best way to automate text messages on a Mac without opening the Messages app?▼

The best way to automate text messages on a Mac without opening the GUI is using the imsg CLI. It reads conversation history, lists recent chats, and sends SMS via the background Messages.app integration.

Related Skills

Explore More Content & Communication Skills→
moltis-orgmoltis-org
2.8k

imsg

Read and send iMessage/SMS via macOS Messages.app from the terminal.

Official
Intermediate
srivtxsrivtx

imessage

Send and receive iMessages/SMS from the terminal via imsg CLI.

Community
Basic
PytaichukBohdanPytaichukBohdan

Fork Terminal Skill

Launch a separate terminal window and run a command via AppleScript or CMD.

Community
Intermediate
0xKobold0xKobold
4

imsg

List chats, view history, and send iMessage and SMS via macOS Messages.app.

Official
Intermediate