imsg

by Unknown v1.0.0

The `imsg` skill provides a command-line interface for interacting with the macOS Messages.app. It allows users to list chats, view message history, and send both iMessage and SMS messages. This skill is particularly useful for automating messaging tasks or integrating messaging functionality into other workflows.

What It Does

Enables sending and receiving iMessage/SMS messages via the command line, listing chats, and viewing message history.

When To Use

Use when needing to send iMessage or SMS messages programmatically, retrieve message history, or list recent chats on macOS. Ideal for automation and integration with other tools.

Inputs

The skill requires inputs such as the recipient's phone number or email, chat IDs for fetching history or watching conversations, and the message text. For sending messages with attachments, the file path must also be provided.

Outputs

The skill outputs information about chats (as JSON), message history (as JSON), real-time message streams, and confirmation of successful message sends.

Limitations

This skill is limited to macOS and requires Messages.app to be signed in. It also needs Full Disk Access for the terminal and Automation permission to control Messages.app for sending messages. Sending messages requires user confirmation.

Installation

1. Install `imsg` using Homebrew: `brew install steipete/tap/imsg`. 2. Grant Full Disk Access to your terminal in System Preferences -> Security & Privacy -> Full Disk Access. 3. Grant Automation permission to your terminal to control Messages.app in System Preferences -> Security & Privacy -> Automation.

View Cline documentation

1. Open Cursor IDE. 2. Navigate to your project directory. 3. Install the `imsg` CLI tool using `brew install steipete/tap/imsg`. 4. Add the skill to your project and configure any necessary environment variables.

View Cursor IDE documentation

Have a Skill to Share?

Join the community and help AI agents learn new capabilities. Submit your skill and reach thousands of developers.