imessage

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

2|Updated Jun 8, 2026
One-click install
npx skills add https://github.com/vikrant-project/devil-agent-ai-platform --skill imessage-vikrant-project
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/vikrant-project/devil-agent-ai-platform/tree/main/agent_core/skills/apple/imessage
Command: npx skills add https://github.com/vikrant-project/devil-agent-ai-platform --skill imessage-vikrant-project

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the process of sending and receiving iMessages/SMS on macOS using the imsg CLI, eliminating the need for direct interaction with the Messages.app interface.

Core Features & Use Cases

  • Message Sending: Send and receive iMessages/SMS directly through the terminal.
  • Chat Management: List chats, view conversation history, and send messages with attachments.
  • Service Options: Choose to send messages via iMessage or SMS based on recipient availability.
  • Use Case: If you want to send an important message to someone, you can quickly access their chat history with the imsg CLI and send a message via iMessage.

Quick Start

Use the 'imsg send --to "+14155551212" --text "Hello!"' command to send an iMessage via the 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?

The imsg CLI requires macOS with Messages.app signed in and the imsg dependency installed. Once configured, you can execute terminal commands to send messages and manage chats directly without interacting with the graphical Messages.app interface.

Can I view iMessage chat history in the command line?

Yes, you can view iMessage chat history in the command line using the imsg CLI. The tool provides terminal-based chat management features that allow you to list active chats and view past conversation history directly within your macOS console.

How do I choose between sending an iMessage or SMS via CLI?

You can choose between sending an iMessage or SMS via CLI by specifying the service selection option in your imsg command. This allows you to route messages through iMessage or standard SMS based on the recipient's availability and network support.

What are the limitations of using the command line for SMS and iMessage?

Limitations of using the command line for SMS and iMessage include strict platform dependency on macOS, requiring Messages.app to be actively signed in, and needing the imsg CLI installed. It is not suitable for non-macOS environments or automated server deployments.