imessage

Send and receive iMessages/SMS via the imsg CLI on macOS.

471|92|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/jasonkneen/openclicky --skill imessage-jasonkneen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/jasonkneen/openclicky/tree/main/AppResources/OpenClicky/OpenClickyBundledSkills/imessage
Command: npx skills add https://github.com/jasonkneen/openclicky --skill imessage-jasonkneen

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill streamlines the process of sending and receiving iMessages/SMS directly from your macOS terminal, eliminating the need for switching between apps and enhancing productivity.

Core Features & Use Cases

  • Send Messages: Quickly send text messages or iMessages with the imsg send command.
  • Read Chats: Access and view the history of iMessage/SMS conversations using imsg history.
  • Watch for New Messages: Monitor for new messages in real-time with imsg watch.
  • Use Case: If you need to send a message to a client on the go, simply use this Skill to compose and send the message directly from your terminal.

Quick Start

Send an iMessage to +14155551212 with the text "Hello!" by running the command: imsg send --to "+14155551212" --text "Hello!"

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessages from the macOS terminal?

To send an iMessage from the macOS terminal, use the `imsg send` command with the recipient's phone number and message text. This requires the imsg CLI and a properly configured macOS Messages.app to deliver texts instantly.

What is the best way to view iMessage chat history without opening the Messages app?

The best way to view iMessage chat history without opening the Messages app is using the `imsg history` command. This fetches and displays your previous SMS and iMessage conversations directly within your macOS terminal interface.

Can I monitor new iMessages in real-time via the command line?

Yes, you can monitor new iMessages in real-time via the command line by executing the `imsg watch` command. This function actively monitors your macOS Messages.app account and streams incoming SMS or iMessage notifications straight to your terminal.

Do I need macOS Messages.app configured to send SMS from the terminal?

Yes, you need macOS Messages.app properly configured to send SMS from the terminal. The Skill relies on the imsg CLI, which integrates directly with your macOS Messages.app environment to route and dispatch text messages successfully.

Why use the terminal for sending iMessages instead of the native Messages app?

Using the terminal for sending iMessages eliminates the need to switch between applications, streamlining your workflow. By executing commands like `imsg send` directly from your macOS command line, you enhance productivity and maintain focus on your current tasks.