wolfiesch/wolfies-executive-function/imessage-gateway

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Complete iMessage CLI with semantic search. The only interface needed for iMessage on macOS. 19x faster than MCP.

Install

npx vskill@latest install wolfiesch/wolfies-executive-function/imessage-gateway

SKILL.md

The same SKILL.md was published earlier as wolfiesch/wolfies-imessage-gateway/imessage-gateway.

EXECUTE IMMEDIATELY

ARGUMENTS: {{ARGUMENTS}}

When arguments are provided, execute via Bash NOW. Add --json flag for data retrieval commands:

bash
python3 ${SKILL_PATH}/../../gateway/imessage_client.py {{ARGUMENTS}}

If no arguments provided, show the Reference section below.

Command Mapping (use FIRST match)

Messaging & Reading
User saysExecute
recent <N>recent --limit <N> --json (default: 50)
find <contact> [for "<query>"]find "<contact>" [--query "<query>"] --limit 50 --json
messages <name> / from <name>messages "<name>" --limit 20 --json
unreadunread --json
send <name> <message>send "<name>" "<message>" (no --json)
send-by-phone <phone> <message>send-by-phone "<phone>" "<message>"
Groups & Media
User saysExecute
groupsgroups --json
attachments [<contact>]attachments ["<contact>"] --json
voice [<contact>]voice ["<contact>"] --json
links [<days>]links --days <N> --json (default: 30)
Analytics & Discovery
User saysExecute
analytics [<contact>] [<days>]analytics ["<contact>"] --days <N> --json (default: 30)
followup [<days>]followup --days <N> --json (default: 7)
contactscontacts --json
handles [<days>]handles --days <N> --json (default: 30)
unknown [<days>]unknown --days <N> --json (default: 7)
summary <name> [<days>]summary "<name>" --days <N> --json (default: 7)
Semantic Search (RAG)
User saysExecute
search "<query>"search "<query>" --json
ask "<question>"ask "<question>" --json
index [<source>]index --source=<source> --json (imessage, superwhisper, notes, local)
statsstats --json
sourcessources --json
clear [<source>]clear [--source=<source>] --force --json

Reference (shown when no arguments provided)

Performance
OperationGateway CLIOld MCPSpeedup
List contacts40ms~763ms19x
Find messages43ms~763ms18x
Unread messages44ms~763ms17x
Groups61ms~763ms12x
Analytics129ms~850ms7x
Semantic search150ms~900ms6x
All Commands (27 total)

Messaging (3)

  • send <contact> <message> - Send to contact
  • send-by-phone <phone> <message> - Send to phone number
  • add-contact <name> <phone> - Add contact

Reading (12)

  • messages, find, recent, unread, handles, unknown
  • attachments, voice, links, thread, scheduled, summary

Groups (2)

  • groups, group-messages

Analytics (3)

  • analytics, followup, reactions

Contacts (1)

  • contacts

Semantic Search/RAG (6)

  • index - Index content for semantic search
  • search - Semantic search across indexed content
  • ask - Get AI-formatted context
  • stats - Knowledge base statistics
  • sources - List available/indexed sources
  • clear - Clear indexed data
Full Command Examples
bash
# Recent messages
python3 ${SKILL_PATH}/../../gateway/imessage_client.py recent --limit 50 --json
 
# Find messages with contact (keyword search)
python3 ${SKILL_PATH}/../../gateway/imessage_client.py find "John" --query "meeting" --limit 50 --json
 
# Messages from contact
python3 ${SKILL_PATH}/../../gateway/imessage_client.py messages "Ever" --limit 20 --json
 
# Unread messages
python3 ${SKILL_PATH}/../../gateway/imessage_client.py unread --json
 
# Send message
python3 ${SKILL_PATH}/../../gateway/imessage_client.py send "Sarah" "Running late!"
 
# Send directly to phone number
python3 ${SKILL_PATH}/../../gateway/imessage_client.py send-by-phone +14155551234 "Hi there!"
 
# Analytics for specific contact
python3 ${SKILL_PATH}/../../gateway/imessage_client.py analytics "John" --days 30 --json
 
# Follow-ups needed
python3 ${SKILL_PATH}/../../gateway/imessage_client.py followup --days 7 --json
 
# List groups
python3 ${SKILL_PATH}/../../gateway/imessage_client.py groups --json
 
# Semantic search (RAG)
python3 ${SKILL_PATH}/../../gateway/imessage_client.py search "dinner plans with Sarah" --json
 
# Index iMessages for semantic search
python3 ${SKILL_PATH}/../../gateway/imessage_client.py index --source=imessage --days 30
 
# Index all local sources (SuperWhisper + Notes)
python3 ${SKILL_PATH}/../../gateway/imessage_client.py index --source=local
 
# Ask a question (AI-formatted context)
python3 ${SKILL_PATH}/../../gateway/imessage_client.py ask "What restaurant did Sarah recommend?"
 
# Knowledge base stats
python3 ${SKILL_PATH}/../../gateway/imessage_client.py stats --json
 
# List available sources
python3 ${SKILL_PATH}/../../gateway/imessage_client.py sources --json
Contact Resolution

Names are fuzzy-matched from config/contacts.json:

  • "John" → "John Doe" (first match)
  • "ang" → "Angus Smith" (partial)
  • Case insensitive
Requirements
  • macOS with Messages.app
  • Python 3.9+
  • Full Disk Access for Terminal
  • Contacts synced via scripts/sync_contacts.py
  • For RAG: OpenAI API key (OPENAI_API_KEY) or local embeddings

Security

  • Security scanPassed, 90 of 100Pattern checks on the skill's files.
  • Model reviewPassed

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

7-day trend score
0

Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/wolfiesch/wolfies-executive-function/imessage-gateway/badge)](https://verified-skill.com/skills/wolfiesch/wolfies-executive-function/imessage-gateway)

Something wrong with this skill or its page? Tell us.