imsg

Manage iMessage and SMS chats from the macOS command line.

1|1|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Rlier/clawdbot --skill imsg-rlier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Rlier/clawdbot/tree/main/skills/imsg
Command: npx skills add https://github.com/Rlier/clawdbot --skill imsg-rlier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a command-line interface to interact with iMessage and SMS on macOS, allowing users to manage chats, view history, and send messages without leaving the terminal.

Core Features & Use Cases

  • Chat Management: List and view conversations from Messages.app.
  • Message History: Retrieve past messages within specific chats, including attachments.
  • Real-time Updates: Monitor incoming messages with a watch command.
  • Sending Messages: Compose and send iMessages or SMS directly from the CLI.
  • Use Case: Quickly send a follow-up message to a client after reviewing your recent conversation history, all from your terminal.

Quick Start

Use the imsg skill to send the text "Hello there!" to the contact with the phone number +1234567890.

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 command line on macOS?

To send iMessages or SMS texts from the CLI, this tool interfaces directly with macOS Messages.app. It supports service selection and allows you to include attachments in your outgoing messages.

Can I view iMessage chat history and past conversations in the terminal?

Yes, you can view iMessage chat history in the terminal. The CLI lists active conversations and retrieves past messages within specific chats, including their attachments.

Does this command-line iMessage tool work on operating systems other than macOS?

No, this CLI requires macOS because it relies on native macOS Messages.app integration. You must have the Messages application configured on your macOS system to manage chats.

What is the best way to monitor incoming iMessages in real time from a terminal?

The best way to monitor incoming iMessages in real time is using the CLI's dedicated watch command. This feature tracks new messages arriving in macOS Messages.app directly within your terminal.

Do I need to install any specific binaries to manage SMS texts via the macOS command line?

Yes, you need the 'imsg' binary installed to manage SMS texts via the command line. This binary provides the interface required to communicate with macOS Messages.app for sending and viewing messages.