Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
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
Here's how your AI assistant might use this skill in practice.
User asks: How often does my friend Alex reach out to me compared to me reaching out first on iMessage?
- 1Look up the contact's phone handle from the local iMessage database
- 2Run analyze.py against the iMessage chat.db for that handle
- 3Parse initiation stats, message counts, and silence gaps from the output
- 4Synthesize 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
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.