imsg

Manage iMessage chats, history, and messages from the terminal.

Updated Jan 28, 2026
One-click install
npx skills add https://github.com/tamireslaeao-prog/ONI_V30 --skill imsg-tamireslaeao-prog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/tamireslaeao-prog/ONI_V30/tree/main/moltbot-main/skills/imsg
Command: npx skills add https://github.com/tamireslaeao-prog/ONI_V30 --skill imsg-tamireslaeao-prog

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS management from the terminal, enabling you to list chats, view history, watch conversations, and send messages without opening the Messages app.

Core Features & Use Cases

  • List chats with imsg chats --limit 10 --json
  • View chat history with imsg history --chat-id 1 --limit 20 --attachments --json
  • Watch a chat for updates with imsg watch --chat-id 1 --attachments
  • Send messages with imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
  • Uses macOS Messages.app integration and required permissions for automation.

Quick Start

Install imsg on macOS and quickly list your chats using imsg chats --limit 10.

Frequently Asked Questions about imsg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages from the terminal using a CLI script?

You can send iMessages from the terminal by executing the command line interface with a target phone number and text payload. This allows programmatic messaging automation without opening the Messages app.

Can I list and view my iMessage chat history from the macOS command line?

Yes, you can list active chats and view chat history from the macOS command line. The tool retrieves conversation logs and attachments directly via terminal commands without launching the Messages app.

What macOS permissions are required to automate iMessage management from the command line?

Automating iMessage management requires macOS Messages.app sign-in, Full Disk Access for your terminal application, and explicit automation permissions to control Messages.app programmatically.

How do I monitor an iMessage conversation for new incoming messages in real time?

You can monitor an iMessage conversation for new incoming messages in real time using the watch command. This terminal function tracks specified chat updates and attachments continuously.

Is there a way to automate sending text messages with attachments on macOS without opening the Messages app?

Yes, you can automate sending text messages with attachments on macOS without opening the Messages app. The CLI accepts a file path parameter to dispatch images alongside text directly from the terminal.