imsg

Read and send iMessages and SMS from the macOS terminal.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

imsg enables reading and sending Messages.app iMessage/SMS directly from the terminal on macOS, simplifying workflow and reducing context switching.

Core Features & Use Cases

  • Read chats and view recent history from Messages.app
  • Send messages programmatically and automate replies
  • Watch chats for new activity and integrate with scripts

Quick Start

Install imsg via Homebrew and then run a few commands to get started:

  • List chats: imsg chats --limit 5 --json
  • Send: imsg send --to "+15551234567" --text "hello world"

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send an iMessage or SMS from the macOS terminal?

You can send an iMessage or SMS from the macOS terminal by installing the imsg binary and executing the send command with the recipient's phone number and text payload to automate Messages.app.

Can I read my iMessage chat history using a command line script?

Yes, you can read iMessage chat history using a command line script by running the imsg chats command, which retrieves recent Messages.app conversations and outputs them in JSON format.

What macOS permissions are required to automate Messages.app from the terminal?

To automate Messages.app from the terminal, you must grant macOS Automation permissions for AppleEvents and Full Disk Access so the imsg binary can interact with your message database.

How do I watch for new iMessages and trigger a script automatically?

You can watch for new iMessages and trigger a script automatically by using the imsg watch command, which monitors Messages.app activity and integrates new chats into your terminal workflows.

What is the best way to automate rapid SMS replies on macOS?

The best way to automate rapid SMS replies on macOS is using the imsg binary to programmatically send messages from the terminal, reducing context switching and streamlining your workflow.