imessage

Send and read iMessages and SMS on macOS via the imsg CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates sending and reading iMessages and SMS on macOS via the imsg CLI.

Core Features & Use Cases

  • Read and list conversations from Messages.app using the imsg tool.
  • Send iMessages or SMS to contacts by phone number or Apple ID, with optional attachments.
  • View chat history and manage recent chats to stay in sync with conversations.

Quick Start

Send an iMessage to a contact via their phone number or Apple ID.

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 tool to automate composing and sending texts to contacts via phone number or Apple ID. This integration requires Messages.app to be signed in.

Can I read chat history in Messages.app via command line?

Yes, you can read chat history in Messages.app via command line by utilizing the imsg CLI. This allows you to list recent conversations and view chat histories directly from the macOS terminal.

Do I need macOS to automate SMS and iMessage sending?

Yes, you need macOS to automate SMS and iMessage sending because the imsg CLI integrates directly with the macOS Messages.app, requiring the system to be signed in with appropriate permissions.

What's the best way to automate text messaging on macOS?

Automating text messaging on macOS is best achieved through the imsg CLI, which reads and sends iMessages or SMS. It includes user confirmations to prevent unintended actions during the messaging automation process.

Can I attach files when sending iMessages through the macOS terminal?

Yes, you can attach files when sending iMessages through the macOS terminal. The imsg CLI supports optional attachments when sending iMessages or SMS to contacts by phone number or Apple ID.

Why does sending an iMessage via CLI require user confirmation?

Sending an iMessage via CLI requires user confirmation to prevent unintended actions. This safeguard ensures that messages are not accidentally sent during automation when using the imsg tool.