imessage

Send and receive iMessages/SMS via macOS command line using imsg CLI.

Updated Jun 22, 2026
One-click install
npx skills add https://github.com/ashiqcodeleaf/long-Run-Agents --skill imessage-ashiqcodeleaf
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/ashiqcodeleaf/long-Run-Agents/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/ashiqcodeleaf/long-Run-Agents --skill imessage-ashiqcodeleaf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This Skill simplifies the process of sending and receiving iMessages/SMS on macOS, allowing users to interact with their messages directly through the terminal.

Core Features & Use Cases

  • Send and Receive Messages: Interact with iMessage and SMS directly from the terminal.
  • View Chat History: Access and review message conversations.
  • Send to Phone Numbers or Apple IDs: Communicate with contacts via iMessage or SMS.

Quick Start

Send a message to a phone number using the imsg CLI.

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?

You can send iMessages from the macOS terminal by using the imsg CLI. This Skill interfaces directly with the Messages.app instance on your macOS system to dispatch messages to phone numbers or Apple IDs.

Can I view iMessage chat history through a command line interface?

Yes, you can view iMessage chat history through the command line interface. By utilizing the imsg CLI on macOS, the Skill allows you to access and review your existing message conversations directly in the terminal.

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

Yes, an active Messages.app instance is required to send SMS from the macOS terminal. The Skill relies on the imsg CLI to communicate with the macOS Messages.app, which handles the actual message routing.

What is the best way to automate sending iMessages on macOS?

The best way to automate sending iMessages on macOS is using the imsg CLI. This Skill provides a command-line interface that interacts with Messages.app, enabling scripted messaging to phone numbers or Apple IDs.

Does the imsg CLI support sending SMS to non-Apple phone numbers?

Yes, the imsg CLI supports sending SMS to non-Apple phone numbers. The Skill facilitates both iMessage and SMS communication via macOS Messages.app, allowing you to reach contacts regardless of their device.

Why is my iMessage CLI script not sending messages?

Your iMessage CLI script may not send messages if the Messages.app instance is inactive or the imsg CLI is improperly installed. This Skill requires both the active macOS Messages.app and the imsg dependency to function correctly.