imsg

Manage iMessage and SMS chats via macOS Messages.app command-line tools.

18|1|Updated Jun 12, 2026

Search Tags:#CLI #command-line #iMessage #SMS #MacOS

Ready to run

npx skills add https://github.com/vignesh2027/Vilvona-AI --skill imsg-vignesh2027

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/vignesh2027/Vilvona-AI/tree/main/skills/imsg
Command: npx skills add https://github.com/vignesh2027/Vilvona-AI --skill imsg-vignesh2027

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a command-line interface to manage iMessage and SMS directly through the macOS Messages.app, streamlining access to messages without the need for a graphical user interface.

Core Features & Use Cases

List and View Chats: Retrieve a list of chats and view history through simple commands.
Send Messages: Send iMessage or SMS with the ability to include attachments.
Service Options: Choose between sending via iMessage or SMS, or let Messages.app decide automatically.

Quick Start

List your recent iMessage chats with the command: imsg chats --limit 10 --json

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 command line by using this Skill to interface directly with macOS Messages.app, allowing you to specify the service type and include attachments.

Can I list and view my iMessage chat history via a CLI tool?▼

Yes, you can list and view iMessage chat history via CLI by executing commands that retrieve recent chats and output the data in JSON format directly from Messages.app.

Does managing iMessage through a CLI require full disk access on macOS?▼

Managing iMessage through a CLI requires full access to the Messages.app on macOS to read chat histories and send messages successfully without permission errors.

How do I specify whether to send a text via iMessage or SMS in a terminal?▼

You can specify whether to send a text via iMessage or SMS in a terminal by using service options within the command, or let Messages.app decide the transport automatically.

What are the limitations of using a command-line interface for Messages.app?▼

A limitation of using a command-line interface for Messages.app is that it requires a macOS environment with full access permissions, lacking the graphical interface for manual browsing.