imsg

Send and receive iMessage and SMS messages via macOS Messages.app.

2|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/simplefarmer69/ape-claw --skill imsg-simplefarmer69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/simplefarmer69/ape-claw/tree/main/data/forge-skills/imsg
Command: npx skills add https://github.com/simplefarmer69/ape-claw --skill imsg-simplefarmer69

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to send and manage iMessage and SMS conversations directly from your command line, integrating with your macOS Messages.app.

Core Features & Use Cases

  • Send Messages: Compose and send text messages, optionally with attachments, to phone numbers or Apple IDs.
  • View History: Retrieve past conversation logs, including attachment information.
  • List Chats: See a list of your recent iMessage/SMS conversations.
  • Use Case: You need to quickly text your colleague a file. You can use this skill to send the file directly via iMessage without leaving your terminal.

Quick Start

Use the imsg skill to send the text "Hello!" to the phone number "+14155551212".

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessages from the command line on macOS?

To send iMessages from the command line, use this Skill to interact with macOS Messages.app, enabling you to compose and send text messages directly from your terminal.

Can I send SMS with attachments using a CLI tool?

Yes, you can send SMS with attachments using this CLI tool. It supports composing messages with files and sending them to phone numbers or Apple IDs through the macOS Messages.app.

How to retrieve iMessage conversation history via terminal?

You can retrieve iMessage conversation history via terminal using this Skill. It allows you to view past conversation logs, including details about any attachments exchanged.

Do I need to sign into Messages.app to send SMS from CLI?

Yes, you need macOS with Messages.app signed in to send SMS from CLI. You must also grant appropriate terminal permissions so the command line can interact with the messaging application.

Can I specify whether to use iMessage or SMS when texting from CLI?

Yes, you can specify whether to use iMessage or SMS when texting from CLI. The Skill supports selecting the specific service for your message transmission.

How do I list recent iMessage chats in terminal?

You can list recent iMessage chats in terminal by using this Skill. It retrieves and displays a list of your recent iMessage and SMS conversations directly in your command line interface.