imsg

Manage Messages.app conversations from the macOS command line.

117|8|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/geezerrrr/motive --skill imsg-geezerrrr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/geezerrrr/motive/tree/main/Motive/Resources/Skills.bundle/imsg
Command: npx skills add https://github.com/geezerrrr/motive --skill imsg-geezerrrr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMsg CLI enables reading and sending iMessages/SMS from macOS directly in the terminal, reducing context switching and enabling automation.

Core Features & Use Cases

  • List chats, view chat history, watch chat activity, and send messages from scripts or interactive sessions.
  • Requires Messages.app to be signed in, Full Disk Access for the terminal, and Automation permission to control Messages.app.

Quick Start

List your recent iMessage conversations from the command line using imsg.

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 on macOS, you can use a CLI tool to control Messages.app. It enables sending messages directly from scripts by requiring Messages.app to be signed in and granted Automation permissions.

Can I view iMessage chat history in the terminal?

Yes, you can view iMessage chat history in the terminal using specific CLI commands. This feature allows you to list recent conversations and retrieve message logs without opening the Messages.app interface.

What permissions are required to automate text messages on macOS?

Automating text messages on macOS requires Full Disk Access for your terminal application and explicit Automation permissions to control Messages.app. The Messages.app must also be actively signed in to your account.

How do I watch for new iMessage updates in an automated script?

You can watch for new iMessage updates in an automated script by executing a specific watch command in your terminal. This monitors chat activity in real-time, allowing scripts to react dynamically to incoming messages.

What is the best way to integrate SMS automation into macOS workflows?

The best way to integrate SMS automation into macOS workflows is using a command-line interface to manage Messages.app. This reduces context switching by executing listing, viewing, and sending tasks directly within interactive sessions or background scripts.

Why does my macOS CLI fail to list chats from Messages.app?

Your macOS CLI fails to list chats from Messages.app when the terminal lacks Full Disk Access or Automation permissions. Ensure Messages.app is signed in and the terminal is explicitly granted these system security privileges.