| name | imessage-signal-analyzer |
| description | Analyze iMessage (macOS) and Signal conversation history to reveal relationship dynamics — message volume, initiation patterns, silence gaps, tone samples, and recent exchanges. Use when asked to analyze messages, read message history, check conversation patterns, or evaluate a relationship based on text history. Works on macOS (iMessage + Signal), Linux/Windows (Signal only). |
iMessage & Signal Analyzer
Analyze iMessage (macOS) and Signal conversations to produce relationship reports.
Prerequisites
macOS (iMessage)
iMessage data is stored locally on macOS. Depending on your security settings, you may need to grant Full Disk Access:
Option 1: Run the script directly with Python (no special permissions needed if you have read access to ~/Library/Messages/chat.db)
Option 2: If you get a permission error, grant Full Disk Access:
- Open System Settings → Privacy & Security → Full Disk Access
- Click + and add Python or your terminal app
Linux / Windows (Signal only)
- iMessage is not available on Linux/Windows
- Signal analysis works via exported JSON
Signal (All Platforms)
- Install signal-cli:
brew install signal-cli (macOS) or see https://github.com/AsamK/signal-cli
- Link your device:
signal-cli link and scan QR code
- Export messages:
signal-cli export --output ~/signal_export.json
Usage
iMessage Analysis
python3 skills/message-analyzer/scripts/analyze.py imessage <phone_or_handle>
Examples:
python3 skills/message-analyzer/scripts/analyze.py imessage
python3 skills/message-analyzer/scripts/analyze.py imessage -- 500
