imessage
SKILL.md
iMessage Management Skill
This skill provides comprehensive Messages app interaction capabilities through command-line tools.
Available Tools
All tools are located in .claude/skills/imessage/ and use either AppleScript or direct SQLite database access to interact with the Messages app.
Database vs AppleScript Approach
- Database tools (
*-db.sh): Read messages directly from the Messages SQLite database (~/Library/Messages/chat.db). More reliable and faster, supports full message history including sent messages with proper text extraction. - AppleScript tools (original): Use AppleScript automation. Sending works reliably, but reading messages may have permission issues on some macOS systems.
Recommended: Use database tools for reading (read-messages-db.sh, check-new-messages-db.sh) and AppleScript for sending (send-message.sh, send-to-chat.sh).
1. Read Messages from Database (read-messages-db.sh) ⭐ RECOMMENDED
Read messages directly from the Messages SQLite database. This is the most reliable method for reading message history.