Skip to content

Search skills.../

Agent Skill Search Engine

Search

Search
Categories
Occupations

About

About
Privacy
Terms

© 2026 Skills Pool. All rights reserved.

Skill File

Imsg

iMessage/SMS CLI for reading, searching, and sending messages

ericfeunekes0 starsMar 12, 2026

Occupation
Categories

CLI Tools

Skill Content

Skill: `imsg` CLI

Read, search, and send iMessage/SMS from the terminal.

Run imsg --help and imsg <command> --help for full command reference.

Ellis-specific flags (always include)

--json — structured output
--limit <n> — bound result size (for read commands)

Requirements

Full Disk Access for terminal (System Settings > Privacy & Security > Full Disk Access)
Messages.app must be signed in

List chats

Recent chats: imsg chats --limit 10 --json
All chats: imsg chats --json

Read chat history

Related Skills

Quick Install

Imsg

npx skillvault add ericfeunekes/ericfeunekes-ellis-skills-skills-imsg-skill-md

Download Skill Open repository

Author: ericfeunekes
stars: 0
Updated: Mar 12, 2026
Occupation

On this page

01Skill: imsg CLI

By chat ID: imsg history --chat-id <id> --limit 20 --json

With attachments: imsg history --chat-id <id> --limit 20 --attachments --json

Date range: imsg history --chat-id <id> --start 2026-01-01T00:00:00Z --json

Send messages

By phone/email: imsg send --to +14155551212 --text "message" --json
By chat ID: imsg send --chat-id <id> --text "message" --json
With attachment: imsg send --to +14155551212 --text "message" --file ~/path/to/file --json
Service selection: --service imessage|sms|auto (defaults to auto)

Reactions

React to latest message: imsg react --chat-id <id> --tapback love --json

Search

Search is done by listing chats and filtering, or by reading history and scanning content.
Use --limit to bound results.

Output format

Always use --json for structured output.
Chat objects include: id, identifier (phone/email), name, service (iMessage/SMS/RCS), last_message_at.
Message objects include: id, sender, text, timestamp, hasAttachment.

Failure handling

"Bad CPU type": binary needs rebuilding for current architecture.
Permission denied: suggest granting Full Disk Access to terminal app.
Messages.app not signed in: report and suggest signing in.

Safety

Confirm with the user before sending messages or reactions.
Handle message content with privacy awareness — don't log or repeat full message bodies unless specifically asked.

02

Ellis-specific flags (always include)

05Read chat history

06Send messages

09Output format

10Failure handling

Software Developers

Oracle

Best practices for using the oracle CLI (prompt + file bundling, engines, sessions, and file attachment patterns).

Blucli

BluOS CLI (blu) for discovery, playback, grouping, and volume.

Peekaboo

Capture and automate macOS UI with the Peekaboo CLI.

Add Dock Band

Add dock band support to your Command Palette extension for persistent toolbar widgets. Use when asked to add dock support, toolbar buttons, persistent UI widgets, taskbar integration, live-updating status displays, quick-access buttons, or always-visible controls. Supports single buttons, multi-button strips, and live-updating content.

microsoft131.8k

Add Fallback Commands

Add fallback commands to your Command Palette extension for catch-all search behavior. Use when asked to add search functionality, query matching, direct input handling, calculator-style evaluation, URL opening, command execution, or results that appear when no other extension matches. Used by 14 of 20 built-in extensions.

microsoft131.8k

Add Adaptive Card Form

Create form-based UI for your Command Palette extension using Adaptive Cards. Use when asked to add forms, user input fields, toggle switches, text inputs, dropdown menus, data entry, surveys, configuration dialogs, or interactive content pages. Supports the Adaptive Cards Designer for visual form building.

microsoft131.8k

Software Developers

Imsg | Skills Pool