imsg

Manage iMessage and SMS conversations from the macOS command line.

1|1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/LuisvelMarketer/genome --skill imsg-luisvelmarketer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/LuisvelMarketer/genome/tree/main/skills/imsg
Command: npx skills add https://github.com/LuisvelMarketer/genome --skill imsg-luisvelmarketer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to interact with their iMessage and SMS conversations directly from the command line, enabling them to list chats, view message history, and send new messages.

Core Features & Use Cases

  • List Chats: View recent iMessage/SMS conversations.
  • View History: Retrieve past messages within a specific chat, with options for attachments.
  • Send Messages: Compose and send new iMessage or SMS messages, with options to specify the service and include attachments.
  • Watch for New Messages: Monitor a specific chat for incoming messages.

Quick Start

Use the imsg skill to send the text "Hello!" to the phone number +14155551212.

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 on macOS using this CLI to specify a recipient and dispatch text messages or files. It interfaces directly with Messages.app to route your communications.

Can I view iMessage chat history and attachments via CLI?

Yes, you can view iMessage chat history via CLI by listing recent conversations and retrieving past messages. The tool retrieves specific chat histories and includes options for viewing attachment details.

Do I need Full Disk Access to manage text messages through a CLI on macOS?

Yes, you need Full Disk Access to manage text messages through a CLI on macOS. The tool also requires Messages.app to be signed in and Automation permissions granted to access local chat databases and send messages.

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

To monitor an iMessage conversation for new incoming messages, you can use the watch functionality provided by the CLI. This feature monitors specific chats via Messages.app and surfaces new incoming texts.

What are the limitations of using a CLI for SMS automation on macOS?

Limitations of using a CLI for SMS automation on macOS include strict dependencies on the Messages.app environment. The tool requires macOS, an active Messages.app sign-in, Full Disk Access, and Automation permissions to function.