ReddRadar
Agent skill
messages
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.
Install this agent skill to your Project
npx add-skill https://github.com/cardmagic/messages/tree/main/skills/messages
SKILL.md
messages
Fuzzy search through Apple Messages using the messages CLI tool.
Installation
If the messages CLI is not installed, install it:
git clone https://github.com/cardmagic/messages.git
cd messages && make install
Requirements:
- macOS with Apple Messages
- Node.js 22+
- Full Disk Access for terminal (System Settings > Privacy & Security > Full Disk Access)
Triggers
Use this skill when user asks about:
- Finding or searching text messages
- Looking up conversations or chats
- Finding what someone said in iMessage
- Searching message history
- Who texted recently, recent messages, contacts
Proactive triggers: "find text", "search messages", "what did X say", "message from", "text about", "iMessage", "look up conversation", "who texted", "recent messages", "recent texts"
Browse Commands
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
Search Commands
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
Other Commands
# Check index stats (message count, date range, etc.)
messages stats
# Rebuild index only
messages index
Options Reference
| 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 |
Tips
- Use quotes around multi-word search terms:
"dinner plans" - Sender filter supports partial matches:
--from "John"matches "John Smith" - Phone numbers can be used in sender filter:
--from "+1555" - Increase
--limitfor broader searches - Increase
--contextto see more conversation around matches
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
cardmagic/notes
notes
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.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
mattpocock/skills
setup-pre-commit
Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, set up Husky, configure lint-staged, or add commit-time formatting/typechecking/testing.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
mattpocock/skills
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
mattpocock/skills
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
Didn't find tool you were looking for?