Agent skill

Imessage

by RedWoodOG in RedWoodOG/Hermes-Desktop

Send and receive iMessages/SMS via the imsg CLI on macOS. An agent skill from RedWoodOG/Hermes-Desktop.

MITAuto-check passedProductivity & Automation

Install Imessage

skills CLI
$ npx skills add RedWoodOG/Hermes-Desktop --skill imessage -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install RedWoodOG/Hermes-Desktop imessage --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/RedWoodOG/Hermes-Desktop.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/apple/imessage .claude/skills/imessage && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
imessage
GitHub stars
177
Used in
4 other repos
Token cost
~606 tokens
SKILL.md length
167 words
Files
1
Skills in repo
62
Repo updated
First seen
Licence
MIT

At a glance

Send and receive iMessages/SMS via the imsg CLI on macOS. An agent skill from RedWoodOG/Hermes-Desktop.

  • Works in 4 steps: Always confirm recipient and message… → Never send to unknown numbers without… → Verify file paths exist before attaching → …
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Prerequisites, When to Use, When NOT to Use and Quick Reference, plus 3 more sections
  • Calls jq and brew

What it does

Imessage is an agent skill from RedWoodOG/Hermes-Desktop. Send and receive iMessages/SMS via the imsg CLI on macOS.

Its SKILL.md is about 610 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Messaging and chat bots. It works with macOS. The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/imessage”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Always confirm recipient and message content before sending
  2. Never send to unknown numbers without explicit user approval
  3. Verify file paths exist before attaching
  4. Don't spam — rate-limit yourself

What it can do on your machine

Read from SKILL.md and the folder at commit be46b39. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • jq
    • brew

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Imessage loads about 606 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 167 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~606

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from RedWoodOG/Hermes-Desktop at commit be46b39, republished under its MIT licence (© RedWoodOG). 167 words, ~606 tokens.

Download SKILL.mdSave it as .claude/skills/imessage/SKILL.md (or your agent's skills folder).
name
imessage
description
Send and receive iMessages/SMS via the imsg CLI on macOS.
version
1.0.0
author
Hermes Agent
license
MIT
platforms
macos
prerequisites.commands
imsg

iMessage

Use imsg to read and send iMessage/SMS via macOS Messages.app.

Prerequisites

  • macOS with Messages.app signed in
  • Install: brew install steipete/tap/imsg
  • Grant Full Disk Access for terminal (System Settings → Privacy → Full Disk Access)
  • Grant Automation permission for Messages.app when prompted

When to Use

  • User asks to send an iMessage or text message
  • Reading iMessage conversation history
  • Checking recent Messages.app chats
  • Sending to phone numbers or Apple IDs

When NOT to Use

  • Telegram/Discord/Slack/WhatsApp messages → use the appropriate gateway channel
  • Group chat management (adding/removing members) → not supported
  • Bulk/mass messaging → always confirm with user first

Quick Reference

List Chats
bash
imsg chats --limit 10 --json
View History
bash
# By chat ID
imsg history --chat-id 1 --limit 20 --json

# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json
Send Messages
bash
# Text only
imsg send --to "+14155551212" --text "Hello!"

# With attachment
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg

# Force iMessage or SMS
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms
Watch for New Messages
bash
imsg watch --chat-id 1 --attachments

Service Options

  • --service imessage — Force iMessage (requires recipient has iMessage)
  • --service sms — Force SMS (green bubble)
  • --service auto — Let Messages.app decide (default)

Rules

  1. Always confirm recipient and message content before sending
  2. Never send to unknown numbers without explicit user approval
  3. Verify file paths exist before attaching
  4. Don't spam — rate-limit yourself

Example Workflow

User: "Text mom that I'll be late"

bash
# 1. Find mom's chat
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mom"))'

# 2. Confirm with user: "Found Mom at +1555123456. Send 'I'll be late' via iMessage?"

# 3. Send after confirmation
imsg send --to "+1555123456" --text "I'll be late"

© RedWoodOG, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/apple/imessage of RedWoodOG/Hermes-Desktop.

Open the folder on GitHubat commit be46b39

Used in 4 other repositories

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 4 other GitHub owners. This page covers the copy in RedWoodOG/Hermes-Desktop, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Imessage next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Imessage compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Imessage this skillRedWoodOG/Hermes-Desktop1774 repos~606Automated safety check: PassMIT
Slack Messaginghaojing8312/WorkClaw141—~897Automated safety check: PassApache-2.0
Imsggeezerrrr/motive1158 repos~273Automated safety check: PassMIT
Prismer ImessagePrismer-AI/PrismerCloud1.6k—~962Automated safety check: PassMIT
Icloud Pp CLImvanhorn/printing-press-library2.1k—~1.9kAutomated safety check: NotesApache-2.0
Yichen Mac Wechat Dual Openmcncarl/yichen-skills4.4k—~1.5kAutomated safety check: PassCustom licence

Similar skills

  • Slack Messaging

    haojing8312/WorkClaw

    A skill your agent uses when asked to send or read Slack messages, check Slack channels, test Slack integrations, or interact with a Slack workspace from the command line.

    141 GitHub stars~897 tokensUpdated 4 mo ago
    Productivity & AutomationAuto-check passed
  • Imsg

    geezerrrr/motive

    iMessage/SMS CLI for listing chats, history, watch, and sending.

    115 GitHub starsUsed in 8 repos~273 tokens
    Productivity & AutomationAuto-check passed
  • Prismer Imessage

    Prismer-AI/PrismerCloud

    Send and receive iMessages/SMS via the imsg CLI on macOS. An agent skill from Prismer-AI/PrismerCloud.

    1.6k GitHub stars~962 tokensUpdated 9 days ago
    Productivity & AutomationAuto-check passed
  • Icloud Pp CLI

    mvanhorn/printing-press-library

    Query your Apple iCloud data from the command line — Photos library storage analysis, iMessage history search and export, largest-file finder, and delete via AppleScript.

    2.1k GitHub stars~1.9k tokensUpdated today
    Productivity & AutomationAuto-check: notes
  • Yichen Mac Wechat Dual Open

    mcncarl/yichen-skills

    Create, inspect, repair, and polish a second WeChat app on macOS by copying WeChat, changing the bundle identifier, ad-hoc re-signing, preparing it for the user to open manually, setting Chinese…

    4.4k GitHub stars~1.5k tokensUpdated 5 days ago
    Productivity & AutomationAuto-check passed
  • Feishu Bridge

    AlexAnys/feishu-openclaw

    Connect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection.

    317 GitHub starsUsed in 1 repo~615 tokens
    Productivity & AutomationAuto-check passed

More from RedWoodOG/Hermes-Desktop

All 62 skills in this repo
  • Excalidraw

    RedWoodOG/Hermes-Desktop

    Create hand-drawn style diagrams using Excalidraw JSON format.

    177 GitHub starsUsed in 5 repos~1.8k tokens
    Auto-check passed
  • Obliteratus

    RedWoodOG/Hermes-Desktop

    Remove refusal behaviors from open-weight LLMs using OBLITERATUS — mechanistic interpretability techniques (diff-in-means, SVD, whitened SVD, LEACE, SAE decomposition, etc.) to excise guardrails…

    177 GitHub starsUsed in 5 repos~3.8k tokens
    Auto-check passed
  • Ascii Video

    RedWoodOG/Hermes-Desktop

    Production pipeline for ASCII art video — any format. An agent skill from RedWoodOG/Hermes-Desktop.

    177 GitHub starsUsed in 2 repos~3.2k tokens
    Auto-check passed
  • Systematic Debugging

    RedWoodOG/Hermes-Desktop

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior.

    177 GitHub starsUsed in 6 repos~2.6k tokens
    Auto-check passed
  • Test Driven Development

    RedWoodOG/Hermes-Desktop

    A skill your agent uses when implementing any feature or bugfix, before writing implementation code.

    177 GitHub starsUsed in 6 repos~2.4k tokens
    Auto-check passed
  • Claude Code

    RedWoodOG/Hermes-Desktop

    Delegate coding tasks to Claude Code (Anthropic's CLI agent).

    177 GitHub starsUsed in 4 repos~784 tokens
    Auto-check passed

Works with

Questions about Imessage

What does Imessage do?

Send and receive iMessages/SMS via the imsg CLI on macOS. An agent skill from RedWoodOG/Hermes-Desktop. Imessage is an agent skill from RedWoodOG/Hermes-Desktop. Send and receive iMessages/SMS via the imsg CLI on macOS.

When should I use Imessage?

Imessage fits situations like: tasks that involve Messaging and chat bots.

How do I install Imessage in Claude Code?

Run `npx skills add RedWoodOG/Hermes-Desktop --skill imessage -a claude-code`. Or copy the skill folder (skills/apple/imessage in RedWoodOG/Hermes-Desktop) into .claude/skills/imessage in your project. Claude Code loads it when a task matches its description.

How do I install Imessage in Codex?

Run `npx skills add RedWoodOG/Hermes-Desktop --skill imessage -a codex`. Or copy the skill folder (skills/apple/imessage in RedWoodOG/Hermes-Desktop) into .agents/skills/imessage in your project. Codex loads it when a task matches its description.

Can I use Imessage in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add RedWoodOG/Hermes-Desktop --skill imessage -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/imessage, .gemini/skills/imessage, .github/skills/imessage and .opencode/skills/imessage in your project.

What does Imessage need to run?

Going by SKILL.md and its folder, Imessage needs the command-line tools its instructions call (jq and brew).

Does Imessage access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Imessage safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Imessage use?

Imessage is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Imessage use?

About 606 tokens (SKILL.md is roughly 2.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Imessage?

Skills that share tags, products or a category with Imessage: Slack Messaging (haojing8312/WorkClaw, 141 stars), Imsg (geezerrrr/motive, 115 stars), Prismer Imessage (Prismer-AI/PrismerCloud, 1.6k stars) and Icloud Pp CLI (mvanhorn/printing-press-library, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Imessage?

RedWoodOG (a GitHub user) maintains it in RedWoodOG/Hermes-Desktop, which has 177 GitHub stars. The repository holds 62 skills in this directory. The repository was last updated on May 30, 2026.

Source: RedWoodOG/Hermes-Desktop on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.