About

Imported from Dbillionaer/wholesaile (skills/imsg/SKILL.md). Install upstream with npx skills add Dbillionaer/wholesaile --skill imsg. Copyright stays with the author.

imsg

Name: imsg
Author: Dbillionaer

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 (Clawdbot 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"

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/dbillionaer-wholesaile-imsg/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

dbillionaer-wholesaile-imsg.ocm.jsonjson

{
  "ocm": "1",
  "id": "dbillionaer-wholesaile-imsg",
  "kind": "skill",
  "name": "imsg",
  "description": "iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.",
  "publisher": "Dbillionaer",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "messaging",
      "communication",
      "imessage",
      "sms",
      "apple",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/Dbillionaer/wholesaile",
      "path": "skills/imsg/SKILL.md",
      "ref": "c74ae3969757fe84b4abec193f37288d088b2a1f",
      "url": "https://github.com/Dbillionaer/wholesaile/blob/c74ae3969757fe84b4abec193f37288d088b2a1f/skills/imsg/SKILL.md",
      "key": "Dbillionaer/wholesaile/skills/imsg/SKILL.md"
    }
  },
  "instructions": "# imsg\n\nUse `imsg` to read and send iMessage/SMS via macOS Messages.app.\n\n## When to Use\n\n✅ **USE this skill when:**\n\n- User explicitly asks to send iMessage or SMS\n- Reading iMessage conversation history\n- Checking recent Messages.app chats\n- Sending to phone numbers or Apple IDs\n\n## When NOT to Use\n\n❌ **DON'T use this skill when:**\n\n- Telegram messages → use `message` tool with `channel:telegram`\n- Signal messages → use Signal channel if configured\n- WhatsApp messages → use WhatsApp channel if configured\n- Discord messages → use `message` tool with `channel:discord`\n- Slack messages → use `s",
  "cost": {
    "context_tokens": 600
  }
}

Fetch it by URL: GET /api/v1/registry/dbillionaer-wholesaile-imsg/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.