skills.rest
travis-burmaster
travis-burmasterCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

imsg

Reads and sends iMessage and SMS messages on macOS via the imsg CLI.

Updated Feb 16, 2026
Search Tags:#messaging#cli#macos#chat history#sms#imessage#send message
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill imsg-travis-burmaster
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/skills/imsg
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill imsg-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Accessing and sending Messages.app conversations from the command line or an AI agent normally requires manual GUI interaction. This Skill lets you list chats, read history, watch conversations, and send iMessage/SMS programmatically on macOS. ## Core Features & Use Cases - List Chats: Retrieve recent conversations with chat IDs in JSON using imsg chats. - Read History & Watch: Fetch message history with attachments or stream incoming messages from a specific chat. - Send Messages: Send text and file attachments to a phone number or email, with control over iMessage vs SMS delivery. - Use Case: Ask your agent to watch a high-priority chat and notify you of new incoming messages, or send a photo to a contact without opening Messages.app. ## Quick Start Use the imsg skill to list my 10 most recent chats and show the history of the first one.

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 from the command line on macOS?▼

Use the imsg CLI with the send command: imsg send --to "+14155551212" --text "hi". You can attach files with --file and choose delivery via --service imessage, sms, or auto.

How do I read iMessage history from the terminal?▼

First run imsg chats --limit 10 --json to find the chat ID, then run imsg history --chat-id <id> --limit 20 --attachments --json to retrieve messages in JSON format.

What permissions does imsg need on macOS?▼

imsg requires Messages.app to be signed in, Full Disk Access granted to your terminal, and Automation permission to control Messages.app for sending messages.

Can imsg send SMS as well as iMessage?▼

Yes, the --service flag accepts imessage, sms, or auto to control delivery. SMS sending depends on your Mac being configured for SMS relay through a paired iPhone.

Does imsg work on Linux or Windows?▼

No, imsg only works on macOS (darwin) because it integrates with Apple's Messages.app. It can be installed via Homebrew with brew install steipete/tap/imsg.

Related Skills

Explore More Personal & Entrepreneur Skills→
swcstudiospaceswcstudiospace

imessage

Send and read iMessage and SMS messages via the imsg CLI on macOS.

Official
Basic
frumu-aifrumu-ai
114

inbox-triage

Categorize incoming messages into action groups and draft replies.

Official
Basic
Exocore-OrganizationExocore-Organization
5

ai-secretary

Draft emails, schedule calendar events, and organize daily workflows.

Official
Advanced
agentic-inagentic-in
577

iMessage

Read Messages.app conversations and send messages via CLI or AppleScript with confirmation.

Official
Intermediate