imessage

Send and receive iMessages/SMS via macOS Messages.app using the imsg CLI.

Updated Apr 29, 2026

Search Tags:#messaging #macOS #terminal #iMessage #SMS

Ready to run

npx skills add https://github.com/fikriaf/agentos --skill imessage-fikriaf

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/fikriaf/agentos/tree/main/src/agentos/skills/apple/imessage
Command: npx skills add https://github.com/fikriaf/agentos --skill imessage-fikriaf

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies sending and receiving iMessages/SMS from macOS directly via the terminal, removing the need for a traditional messaging app.

Core Features & Use Cases

iMessage/SMS Messaging: Send and receive messages directly through macOS Messages.app.
CLI Integration: Use terminal commands for efficient messaging.
Use Case: Quickly send an iMessage to a friend without opening your messaging app.

Quick Start

Use the imessage skill to send an iMessage to your friend's phone number: imsg send --to "+1234567890" --text "Hey, what's up?"

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?▼

To send an iMessage from the macOS terminal, use the imsg CLI to specify a recipient and message text. This routes your input directly through the Messages.app to deliver the SMS or iMessage.

Can I receive iMessages via command line on macOS?▼

Yes, you can receive iMessages via command line on macOS. The CLI integrates with the native Messages.app to fetch incoming SMS and iMessage data directly within your terminal environment.

Do I need to be signed into Messages.app to send SMS from the terminal?▼

Yes, you must be signed into the Messages.app to send SMS from the terminal. The CLI relies on the macOS Messages.app infrastructure to authenticate your account and route messages successfully.

What is the best way to automate text messaging without opening a Mac app?▼

Automating text messaging without opening a Mac app is best achieved using a terminal CLI for iMessage. It allows you to trigger SMS sends programmatically via simple shell commands.

Does terminal iMessage messaging work on non-Apple operating systems?▼

Terminal iMessage messaging does not work on non-Apple operating systems. The functionality depends entirely on the macOS Messages.app to process and send your SMS and iMessage payloads.