skills.rest
zkcpku
zkcpkuCOMMUNITY
Explore all skills by this author →
GitHub

imsg

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

  • List Chats: View a list of your iMessage/SMS conversations.
  • View History: Retrieve message history for specific chats, including attachments.
  • Send Messages: Compose and send text messages or messages with attachments.
  • Real-time Updates: Monitor incoming messages with a watch command.

Quick Start

Use the imsg skill to list the 10 most recent chats in JSON format.

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 macOS command line using the imsg binary to compose and dispatch text messages or attachments. This CLI tool interfaces directly with Messages.app to automate sending without requiring the graphical interface.

Can I retrieve iMessage chat history with attachments via CLI?▼

Yes, retrieving iMessage chat history with attachments via CLI is supported by querying specific chats. The tool extracts message histories and their associated attachment files, outputting the data in structured JSON format for terminal viewing or scripting.

How do I monitor incoming iMessages in real time on macOS?▼

You can monitor incoming iMessages in real time on macOS by executing the watch command provided by the imsg CLI. This function streams live message updates directly to your terminal as they are received by the Messages app.

Do I need special macOS permissions to automate Messages.app via CLI?▼

Yes, automating Messages.app via CLI requires granting necessary macOS permissions to the imsg binary. You must configure Full Disk Access and Automation permissions in your system security settings for the tool to read chats and send messages.

How do I list recent SMS and iMessage conversations in JSON format?▼

You can list recent SMS and iMessage conversations in JSON format by running the list chats command in the imsg CLI. This outputs your most recent active conversations, allowing you to easily parse chat identifiers for subsequent message retrieval or sending.

Related Skills

Explore More Software Engineering Skills→
hongmaple0820hongmaple0820
9

imsg

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

Community
Intermediate
breakcafebreakcafe
1

pdf-reader

Extract text from local PDFs, URLs, and WhatsApp attachments to stdout.

Official
Intermediate
dakshrawat298-gifdakshrawat298-gif

imsg

Read and send iMessages and SMS from the macOS terminal.

Community
Advanced
Yogi-076Yogi-076

imsg

List chats, view history, watch updates, and send messages via the imsg CLI.

Community
Intermediate