skills.rest
cxnaive
cxnaiveCOMMUNITY
Explore all skills by this author →
GitHub

imessage

Read and send iMessage and SMS messages via the macOS Messages app.

Updated Jun 17, 2026
Search Tags:#automation#messaging#macos#terminal#sms#imessage
One-click install
npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill imessage-cxnaive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/cxnaive/hermes-agent-llbot/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/cxnaive/hermes-agent-llbot --skill imessage-cxnaive

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your messaging workflow and your terminal, allowing you to manage iMessage and SMS conversations without leaving your command-line interface.

Core Features & Use Cases

  • Message Management: Read conversation history and check recent chats directly from the terminal.
  • Communication: Send text messages or attachments to contacts via iMessage or SMS.
  • Use Case: Quickly text a colleague or family member about your status or share a file without switching context from your current terminal session.

Quick Start

Use the imessage skill to send a text message to a specific phone number or contact.

Frequently Asked Questions about imessage

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

FAQPage Schema
Can I send and receive iMessages directly from the macOS terminal?▼

Yes, you can send and receive iMessages directly from the macOS terminal. This functionality bridges your messaging workflow to the command line, allowing you to dispatch texts and read chat history without switching contexts.

How do I send an SMS or text message to a contact using the command line?▼

To send an SMS or text message via the command line, you use a CLI tool to interface with the macOS Messages application. This lets you dispatch text and file attachments to specific recipients directly from your terminal.

Do I need to grant full disk access to use terminal-based messaging automation on macOS?▼

Yes, terminal-based messaging automation requires appropriate macOS system permissions for full disk access and automation. You must grant these privileges to allow the CLI tool to query chats and dispatch messages through the macOS Messages app.

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

Querying iMessage chat history without opening the app is best achieved through command-line automation. This approach supports listing active conversations and reading communication history directly within your terminal interface.

Does terminal messaging support sending file attachments to iMessage contacts?▼

Yes, terminal messaging supports sending file attachments to iMessage contacts. The communication feature allows you to dispatch both text messages and files to specific recipients via the macOS Messages application.

Why is my imsg CLI tool not sending iMessages from the terminal?▼

If the imsg CLI tool is not sending iMessages from the terminal, it typically indicates missing macOS system permissions. The tool requires explicit full disk access and automation privileges to interface correctly with the Messages application.

Related Skills

Explore More Content & Communication Skills→
kaminocorpkaminocorp
228

imessage

Send and read iMessages on macOS via the imsg CLI.

Official
Intermediate
Solitude01Solitude01

session-logs

Query session JSONL logs with jq and rg to extract messages and timestamps.

Community
Intermediate
yoonhwanyoonhwan
3

imsg

Send iMessage/SMS messages and control macOS Messages.app from terminal scripts.

Community
Intermediate
anilcan-karaanilcan-kara

imessage

Manage iMessages from the macOS command line via imsg.

Community
Intermediate