plugins/messages/skills/messages/SKILL.md
Fuzzy search and browse Apple Messages/iMessage. Use when user asks to find texts, search messages, look up conversations, find what someone said, who texted recently, or view recent messages.
npx skillsauth add cardmagic/ai-marketplace messagesInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Fuzzy search through Apple Messages using the messages CLI tool.
If the messages CLI is not installed, install it:
git clone https://github.com/cardmagic/messages.git
cd messages && make install
Requirements:
Use this skill when user asks about:
Proactive triggers: "find text", "search messages", "what did X say", "message from", "text about", "iMessage", "look up conversation", "who texted", "recent messages", "recent texts"
For browsing recent messages and conversations (no search query needed):
# Show most recent messages (answers "who texted me?")
messages recent
# List contacts by recent activity
messages contacts --limit 10
# List conversations with message counts
messages conversations
# Show recent messages from/to a specific person
messages from "John"
# Show full conversation thread with someone
messages thread "John" --after 2024-12-01
For fuzzy searching through message content:
# Rebuild index and search (recommended)
messages index-and-search "search query"
# Search with filters
messages search "query" --from "John"
messages search "query" --after 2024-06-01
messages search "query" --limit 25
messages search "query" --context 5
# Combine options
messages search "dinner" --from "Mom" --after 2024-01-01 --limit 15
# Check index stats (message count, date range, etc.)
messages stats
# Rebuild index only
messages index
| Option | Description | Example |
|--------|-------------|---------|
| --from, -f | Filter by sender name or phone | --from "John Smith" |
| --after, -a | Messages after date | --after 2024-06-01 |
| --limit, -l | Max results (default: 10) | --limit 25 |
| --context, -c | Messages before/after match (default: 2) | --context 5 |
"dinner plans"--from "John" matches "John Smith"--from "+1555"--limit for broader searches--context to see more conversation around matchestools
Search, create, and complete Apple Reminders. Use when user asks about tasks, todos, reminders, grocery lists, or wants to add/complete items.
tools
Search, browse, create, and delete Apple Notes. Use when user asks about notes, wants to find something in notes, create a new note, or delete notes.
tools
# Text Classification with Classifier Use when: User asks to classify text, detect spam, analyze sentiment, detect emotions, or use pre-trained ML models. ## Pre-trained Models Run `classifier models` to see all available models. Common ones: | Model | Command | Use Case | |-------|---------|----------| | `sms-spam-filter` | `classifier -r sms-spam-filter "text"` | Spam detection | | `imdb-sentiment` | `classifier -r imdb-sentiment "text"` | Sentiment analysis | | `emotion-detection` | `clas
data-ai
Example TaskFlow authoring pattern for inbox triage. Use when messages need different treatment based on intent, with some routes notifying immediately, some waiting on outside answers, and others rolling into a later summary.