skills.rest
HugoAlmeidaMoreira
HugoAlmeidaMoreiraCOMMUNITY
Explore all skills by this author →
GitHub

imessage

Send and read iMessages from the macOS terminal using the imsg CLI.

Updated Aug 27, 2026
Search Tags:#automation#messaging#communication#macos#terminal#imessage#imsg
One-click install
npx skills add https://github.com/HugoAlmeidaMoreira/zeus-agent --skill imessage-hugoalmeidamoreira
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/HugoAlmeidaMoreira/zeus-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/HugoAlmeidaMoreira/zeus-agent --skill imessage-hugoalmeidamoreira

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables sending and reading iMessages/SMS directly from the macOS terminal using the imsg CLI, reducing context switching and manual interaction with Messages.app.

Core Features & Use Cases

  • Read chats and history from Messages.app to stay updated without opening the app
  • Send iMessages or SMS to phone numbers or Apple IDs directly from the CLI
  • Quick workflows for listing chats, viewing history, and composing messages in scripted tasks

Quick Start

Tell it to send a message to a contact, for example: send 'Hello' to +15551234567.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send an iMessage from the macOS terminal?▼

You can send an iMessage from the macOS terminal by using the imsg CLI to specify a recipient's phone number or Apple ID and your message text. This allows direct sending from the command line without opening Messages.app.

Can I read iMessage chat history in the terminal?▼

Yes, you can read iMessage chat history in the terminal using the imsg CLI. It supports listing active chats and viewing message history, letting you stay updated on conversations without manually opening the Messages.app interface.

Do I need Messages.app enabled to send iMessages from the CLI?▼

Yes, you need macOS with Messages.app enabled and the imsg CLI installed to send iMessages from the CLI. The tool interfaces directly with the native macOS messaging environment to compose and dispatch texts.

What is the best way to automate sending SMS on macOS?▼

The best way to automate sending SMS on macOS is using the imsg CLI within your terminal scripts. It enables automated workflows for composing and sending messages to phone numbers, reducing manual context switching.

Does the CLI prompt for confirmation before sending an iMessage?▼

Yes, the imsg CLI prompts for confirmation before dispatching an iMessage. This safeguard ensures you can review the recipient and message content before the text is actually sent from your macOS device.

Related Skills

Explore More Content & Communication Skills→
kcns008kcns008
5

imsg

List and send iMessage and SMS conversations from macOS Messages.app.

Community
Intermediate
JoeyJoziahJoeyJoziah

imsg

List chats, read history, watch threads, and send iMessage or SMS messages from the command line.

Community
Intermediate
PytaichukBohdanPytaichukBohdan

Fork Terminal Skill

Launch a separate terminal window and run a command via AppleScript or CMD.

Community
Intermediate
dvdsgldvdsgl
54

imessage

Read and send iMessages via sqlite3 and AppleScript on macOS.

Community
Advanced