imsg

List chats, read history, watch threads, and send iMessage or SMS messages from the command line.

Updated Aug 13, 2025
One-click install
npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill imsg-joeyjoziah
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/JoeyJoziah/investment-analysis-platform/tree/main/.claude/skills/imsg
Command: npx skills add https://github.com/JoeyJoziah/investment-analysis-platform --skill imsg-joeyjoziah

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of opening Messages.app for routine chat review, conversation monitoring, and sending texts on macOS.

Core Features & Use Cases

  • Chat Discovery: List recent conversations to quickly find the right thread.
  • Message History: Read prior messages in a chat, including attachment-aware context when needed.
  • Live Monitoring: Watch a conversation for incoming messages in real time.
  • Sending Messages: Send iMessage or SMS messages directly from the command line.
  • Use Case: A support operator can inspect a customer thread, verify the latest context, and reply without leaving the terminal.

Quick Start

Use the imsg skill to list my recent chats and show the last 20 messages in the selected conversation.

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

You can send iMessage or SMS from the macOS terminal by using the imsg CLI to interface with Messages.app. It requires an active Messages.app sign-in and proper Automation permissions to execute send commands directly from your command line.

Can I read and monitor macOS Messages.app chat history from the command line?

Reading and monitoring macOS Messages.app chat history from the command line is possible with the imsg CLI. It lists recent conversations, displays prior message history including attachment context, and watches active threads for real-time incoming messages.

What macOS permissions do I need to automate text messages via the command line?

Automating text messages via the command line requires Full Disk Access and Automation permission granted to the terminal or imsg CLI. You must also be signed into Messages.app on your macOS system for reliable send and read operations.

Is there a way to list recent iMessage conversations without opening the Messages app?

Listing recent iMessage conversations without opening the Messages app is achievable using the imsg CLI for chat discovery. This terminal-based messaging workflow allows you to quickly find and select the right thread directly from your command line interface.

Why is my command line iMessage automation not sending texts successfully?

Command line iMessage automation may fail to send texts if the imsg CLI lacks Full Disk Access or Automation permission. Successful message monitoring and sending require an active Messages.app sign-in and proper macOS security permissions.

Does the imsg CLI support viewing attachment context when reading message history?

The imsg CLI supports viewing attachment-aware context when reading message history in a chat. This allows you to inspect prior messages and verify the latest context including attachments without leaving your terminal environment.