skills.rest
lehalpaul
lehalpaulCOMMUNITY
Explore all skills by this author →
GitHub

imsg

Manage iMessage and SMS conversations from a command-line interface on macOS.

Updated Feb 4, 2026
Search Tags:#messaging#communication#cli#macos#sms#imessage
One-click install
npx skills add https://github.com/lehalpaul/agents --skill imsg-lehalpaul
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/lehalpaul/agents/tree/main/skills/imsg
Command: npx skills add https://github.com/lehalpaul/agents --skill imsg-lehalpaul

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a command-line interface for interacting with iMessage and SMS on macOS, enabling users to manage chats, view history, and send messages without leaving their terminal.

Core Features & Use Cases

  • List Chats: View recent iMessage/SMS conversations with their IDs.
  • Fetch History: Retrieve message history for a specific chat, including attachments.
  • Send Messages: Compose and send text messages and messages with attachments.
  • Watch Chats: Stream incoming messages in real-time for a selected chat.
  • Use Case: Quickly send a status update to a specific contact or group chat directly from your terminal, or review the latest messages in a critical conversation.

Quick Start

Use the imsg skill to list the last 10 chats.

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

You can send iMessage and SMS texts directly from the macOS terminal by using this CLI to compose and send messages, optionally including file attachments, without opening the Messages application.

Do I need special macOS permissions to automate iMessage via command line?▼

Automating iMessage via command line requires necessary macOS permissions for Messages.app control and the imsg binary to be installed, ensuring the CLI can securely access your chat data and send messages.

Can I view iMessage chat history and attachments through a CLI?▼

Viewing iMessage chat history and attachments through a CLI is supported, allowing you to fetch message history for specific chats and retrieve associated files directly in your terminal output.

Is there a way to monitor iMessage conversations in real time on macOS?▼

Real-time iMessage monitoring on macOS is possible using the watch chats feature, which streams incoming messages for a selected conversation directly to your terminal interface as they arrive.

What is the best way to list recent SMS and iMessage chats without the Messages app?▼

The best way to list recent SMS and iMessage chats without the Messages app is using the list chats command, which outputs recent conversation identifiers and titles directly to your terminal.

Related Skills

Explore More Software Engineering Skills→
rnbenrnben

imessage

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

Community
Intermediate
ShenSeanChenShenSeanChen
16

WhatsApp Chat Parser

Parse WhatsApp chat exports into structured JSON data.

Community
Basic
x402agentx402agent

imsg

Control iMessage and SMS via a macOS CLI for Messages.app.

Community
Intermediate
DotNetAgeDotNetAge
32

imessage

Send iMessage or SMS messages to contacts via AppleScript CLI.

Community
Basic