skills.rest
Bitterbot-AI
Bitterbot-AIOFFICIAL
Explore all skills by this author →
Website𝕏@Bitterbot_AIGitHub

imsg

Control iMessage/SMS from the macOS terminal to list chats, fetch history, watch conversations, and send messages.

2.5k|423|Updated Mar 28, 2026
Search Tags:#automation#messaging#cli#macos#sms#imessage
One-click install
npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill imsg-bitterbot-ai
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Bitterbot-AI/bitterbot-desktop/tree/main/skills/imsg
Command: npx skills add https://github.com/Bitterbot-AI/bitterbot-desktop --skill imsg-bitterbot-ai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Listing, reading, and sending iMessage/SMS from the terminal on macOS, enabling automation and scripting of conversations without switching apps.

Core Features & Use Cases

  • List chats with imsg chats
  • Fetch chat history with imsg history
  • Watch a chat with imsg watch
  • Send messages with imsg send
  • Use cases: automate reminders, integrate messaging into workflows, or build chat bots that respond via Messages.

Quick Start

Install imsg and grant the required macOS permissions, then run imsg to manage iMessage from the terminal.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send and receive iMessage texts from the macOS terminal?▼

You can automate iMessage tasks from the macOS terminal by running commands to list chats, fetch history, watch conversations, and send messages. This allows scripting messaging workflows without manually opening the Messages app.

What macOS permissions are required to automate SMS messaging via CLI?▼

Automating SMS via CLI requires Messages to be signed in, Terminal Full Disk Access, and Automation permissions to control Messages.app. These enable secure reading and sending of texts in terminal workflows.

Can I watch an active iMessage conversation in real time from the command line?▼

Yes, you can watch an active iMessage conversation from the command line. The watch feature monitors ongoing chats directly in the terminal, supporting continuous observation for automation and bot integration.

What is the best way to integrate iMessage chats into automated macOS workflows?▼

Integrating iMessage chats into automated macOS workflows is done via terminal commands to list, read, and send messages. This enables scripting tasks like automated reminders or building chat bots responding via Messages.

Why does my command line script fail to read iMessage history on macOS?▼

Command line scripts fail to read iMessage history when Terminal lacks Full Disk Access or Messages is not signed in. Granting these permissions resolves the issue and allows the CLI to fetch chat records.

Related Skills

Explore More Content & Communication Skills→
tamireslaeao-progtamireslaeao-prog

imsg

Manage iMessage chats, history, and messages from the terminal.

Community
Intermediate
lidge-junlidge-jun
5

telegram-send

Send text, photos, voice messages, and documents to Telegram chat IDs via Bot API.

Community
Intermediate
jasonkneenjasonkneen
471

apple-reminders

Manage Apple Reminders via remindctl terminal commands.

Community
Basic
drshailesh88drshailesh88

imsg

Read and send iMessages and SMS from the macOS terminal.

Community
Advanced