imsg

List iMessage and SMS conversations, retrieve history, and send messages via Messages.app.

1|Updated May 12, 2026

Search Tags:#messaging #macos #attachments #sms #imessage #messages.app

Ready to run

npx skills add https://github.com/estebanrfp/gos --skill imsg-estebanrfp

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/estebanrfp/gos/tree/main/skills/imsg
Command: npx skills add https://github.com/estebanrfp/gos --skill imsg-estebanrfp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of manually opening Messages.app when you need to find a conversation, review recent chats, or send an iMessage or SMS from your Mac.

Core Features & Use Cases

Chat discovery: List recent conversations and identify the right recipient quickly.
History and monitoring: Inspect past messages, attachments, and new incoming messages for a specific chat.
Message sending: Send text or file attachments via iMessage, SMS, or automatic routing from macOS.
Use case: A user asks you to text a contact that they will be late, and you locate the correct chat, confirm the message, and send it safely.

Quick Start

Ask the assistant to use imsg to find the right chat and send the confirmed message to the specified recipient.

Frequently Asked Questions about imsg

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

FAQPage Schema

How do I send an iMessage or SMS from macOS without opening Messages.app?▼

To send an iMessage or SMS from macOS without opening Messages.app, you can use an automation Skill to locate the correct chat and trigger outbound delivery automatically through the imsg CLI. It handles text and file attachments safely.

Can I retrieve iMessage chat history and attachments on macOS?▼

Yes, you can retrieve iMessage chat history and attachments on macOS by listing recent conversations and inspecting past messages for a specific chat. This Skill monitors new incoming messages and reviews past attachments directly.

Do I need the imsg CLI to read and send iMessage conversations on a Mac?▼

Yes, you need the imsg CLI installed to read and send iMessage conversations, alongside macOS Messages.app access and automation permission. These prerequisites allow the system to discover chats and route outbound delivery.

What is the best way to monitor incoming iMessage chats for support workflows?▼

The best way to monitor incoming iMessage chats for support workflows is to use an automation Skill that lists recent conversations and continuously inspects new incoming messages for specific chats. This enables quick review and response without manual app interaction.

Does this iMessage automation Skill support sending file attachments?▼

Yes, this iMessage automation Skill supports sending file attachments alongside text messages. It routes files automatically via iMessage or SMS through the macOS Messages.app, handling attachment delivery for personal and support workflows.

Why is my iMessage automation not working on macOS?▼

Your iMessage automation might not be working on macOS because it requires the imsg CLI, active Messages.app access, and explicit automation permission granted to the controlling assistant. Missing any of these dependencies prevents chat discovery and message delivery.