Agent Skills › spinabot/brigade › imsg

imsg

GitHub

macOS平台下通过CLI管理iMessage/SMS的工具，支持查看聊天记录、监控新消息及发送文本或附件。需Mac系统授权，强制要求发送前确认接收人与内容，保障安全。

skills/imsg/SKILL.md spinabot/brigade

Trigger Scenarios

用户明确要求发送iMessage或SMS 查询iMessage对话历史检查最近的Messages.app聊天列表

Install

npx skills add spinabot/brigade --skill imsg -g -y

More Options

Use without installing

npx skills use spinabot/brigade@imsg

指定 Agent (Claude Code)

npx skills add spinabot/brigade --skill imsg -a claude-code -g -y

安装 repo 全部 skill

npx skills add spinabot/brigade --all -g -y

预览 repo 内 skill

npx skills add spinabot/brigade --list

SKILL.md

Frontmatter

{
    "name": "imsg",
    "homepage": "https:\/\/imsg.to",
    "metadata": {
        "brigade": {
            "os": [
                "darwin"
            ],
            "emoji": "📨",
            "install": [
                {
                    "id": "brew",
                    "bins": [
                        "imsg"
                    ],
                    "kind": "brew",
                    "label": "Install imsg (brew)",
                    "formula": "steipete\/tap\/imsg"
                }
            ],
            "requires": {
                "bins": [
                    "imsg"
                ]
            }
        }
    },
    "description": "iMessage\/SMS CLI for listing chats, history, and sending messages via Messages.app."
}

imsg

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

When to Use

✅ USE this skill when:

User explicitly asks to send iMessage or SMS
Reading iMessage conversation history
Checking recent Messages.app chats
Sending to phone numbers or Apple IDs

When NOT to Use

❌ DON'T use this skill when:

Telegram messages → use message tool with channel:telegram
Signal messages → use Signal channel if configured
WhatsApp messages → use WhatsApp channel if configured
Discord messages → use message tool with channel:discord
Slack messages → use slack skill
Group chat management (adding/removing members) → not supported
Bulk/mass messaging → always confirm with user first
Replying in current conversation → just reply normally (Brigade routes automatically)

Requirements

macOS with Messages.app signed in
Full Disk Access for terminal
Automation permission for Messages.app (for sending)

Common Commands

List Chats

imsg chats --limit 10 --json

View History

# By chat ID
imsg history --chat-id 1 --limit 20 --json

# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json

Watch for New Messages

imsg watch --chat-id 1 --attachments

Send Messages

# Text only
imsg send --to "+14155551212" --text "Hello!"

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

# Specify service
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms

Service Options

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

Safety Rules

Always confirm recipient and message content before sending
Never send to unknown numbers without explicit user approval
Be careful with attachments — confirm file path exists
Rate limit yourself — don't spam

Example Workflow

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

# 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"