imessage-signal-analyzer
by terellison
Apple Apps & ServicesBrief
Analyze iMessage (macOS) and Signal conversation history to reveal relationship dynamics — message volume.
Description
What This Skill Does
Reads iMessage (macOS) and Signal conversation history to produce relationship reports covering message volume, initiation patterns, silence gaps, tone samples, and recent exchanges. Works on macOS for both platforms; Linux and Windows support Signal only via exported JSON.
Reads directly from local iMessage and Signal databases rather than requiring manual scrolling through years of chat history.
When to Use It
- Seeing who initiates conversations more in a friendship
- Finding when a long-distance relationship was most active
- Spotting long silence periods in a chat history
- Reviewing message history before reconnecting with someone
- Checking if communication with a family member has dropped off
Example Workflow
User asks: How often does my friend Alex reach out to me compared to me reaching out first on iMessage?
- 1
Look up the contact's phone handle from the local iMessage database
- 2
Run analyze.py against the iMessage chat.db for that handle
- 3
Parse initiation stats, message counts, and silence gaps from the output
- 4
Synthesize findings into a conversational summary of the relationship dynamic
Report showing that Alex initiates 62% of conversations, with a notable 45-day gap in mid-2023 and highest message volume in 2021
Requirements
- signal-cli installed and device linked (for Signal analysis)
- macOS Full Disk Access permission granted to Python or terminal app (if iMessage access is blocked)
Installation
clawhub install terellison/imessage-signal-analyzerRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.