imsg

List, fetch, watch, and send iMessages and SMS from the terminal.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/balic-AI-ML-R-D-Resources/eliza_autonomous_agents --skill imsg-balic-ai-ml-r-d-resources
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/balic-AI-ML-R-D-Resources/eliza_autonomous_agents/tree/main/packages/skills/skills/imsg
Command: npx skills add https://github.com/balic-AI-ML-R-D-Resources/eliza_autonomous_agents --skill imsg-balic-ai-ml-r-d-resources

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read, watch, and send iMessages and SMS from the terminal to automate conversations and improve productivity.

Core Features & Use Cases

  • List chats from Messages.app in the terminal
  • Fetch chat history and stream new messages in real time
  • Send messages to contacts by phone number or email, with optional attachments
  • Use for automated notification sending and archival logging of conversations

Quick Start

Open a terminal and run imsg chats --limit 5 --json to list recent chats.

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

You can send iMessages from the macOS terminal by using a CLI tool to interact with the Messages app. It requires granting terminal Full Disk Access and Automation permission to control Messages.app, allowing you to send texts with optional attachments.

Can I read and fetch chat history from the Messages app in macOS?

Yes, you can read and fetch chat history from the Messages app in macOS by running terminal commands. The CLI allows you to list recent chats and retrieve past conversation logs directly in your terminal window.

What permissions do I need to automate SMS tasks on macOS?

To automate SMS tasks on macOS, you need Full Disk Access for your terminal and Automation permission to control Messages.app. You also need to ensure your terminal has access to the Messages app database.

Is it possible to watch and stream new iMessages in real time from the command line?

Yes, it is possible to watch and stream new iMessages in real time from the command line. The CLI supports watching conversations, allowing you to monitor incoming SMS and iMessage traffic as it arrives.

How do I send attachments with iMessage using a CLI on macOS?

You can send attachments with iMessage using a CLI on macOS by specifying the file path in your send command. The tool supports sending messages to contacts by phone number or email, including optional file attachments.

What is the best way to automate iMessage notifications from a script?

The best way to automate iMessage notifications from a script is using a macOS CLI tool that interacts directly with the Messages app. This allows you to programmatically send SMS and iMessage alerts to contacts without manual intervention.