imsg

Sends text messages and attachments, retrieves chat history, monitors incoming SMS/iMessage via macOS Messages app.

1|Updated May 3, 2026
One-click install
npx skills add https://github.com/brikkoAI/brikko-studio --skill imsg-brikkoai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/brikkoAI/brikko-studio/tree/main/packages/core/skills/imsg
Command: npx skills add https://github.com/brikkoAI/brikko-studio --skill imsg-brikkoai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need to manually switch between your terminal and the macOS Messages app to send texts, review chat history, or manage iMessage conversations, so you can handle all messaging tasks without disrupting your existing workflow.

Core Features & Use Cases

  • iMessage/SMS Messaging: Send text messages and file attachments to phone numbers or Apple IDs, with the option to force iMessage or SMS service as needed.
  • Chat History Access: Retrieve past conversation threads, view message details including attachments, and monitor new incoming messages in real time.
  • Use Case Example: If you need to follow up with a client about a project deliverable, you can quickly pull up your recent chat with them to reference prior context, then send your follow-up message without opening the Messages app manually.

Quick Start

Use the imsg skill to send a text message to the phone number +1555123456 with the content "Your order has shipped" after you confirm the recipient is correct with me.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send and read iMessage directly from the macOS terminal?

You can send and read iMessage directly from the macOS terminal by using a command line interface skill that interacts with the Messages app to send texts, attachments, and retrieve chat history without opening the app.

What macOS permissions are required to send SMS from the command line?

Sending SMS from the command line requires a macOS device with a signed-in Messages app, Full Disk Access granted to the terminal, and Automation permission enabled for Messages.app to operate correctly.

Can I retrieve iMessage chat history and monitor incoming messages in terminal?

Yes, retrieving iMessage chat history and monitoring incoming messages in terminal is possible. You can pull past conversation threads, view message details including attachments, and monitor new incoming messages in real time.

How do I send file attachments via iMessage using a CLI tool?

To send file attachments via iMessage using a CLI tool, you target the recipient's phone number or Apple ID and specify the attachment file path in your terminal command, forcing iMessage or SMS service as needed.

Does terminal-based iMessage messaging work without switching to the Messages app?

Terminal-based iMessage messaging works without switching to the Messages app by executing commands directly in your terminal. It eliminates manual context switching, allowing you to handle personal and professional communication tasks within your existing workflow.

Are there limitations to managing SMS communications through a terminal CLI?

A key limitation of managing SMS communications through a terminal CLI is platform dependency. It strictly requires a macOS device with an active Messages app configuration. It will not function on Linux or Windows environments.