Your year in comms

WRAPPED2025

Your communication habits, exposed. Messages, calls, response times, personality type. Works with iMessage, WhatsApp, and Phone.

Get Started

Requires a Mac to run. Send yourself this link!

macOS only
100% local
~30 seconds

100% local. Zero network access.

Your messages never leave your computer. No servers, no uploads, no tracking, no internet connection required.

What it reads: Only metadata (timestamps, sender info, counts) + emojis. It does NOT read your actual message text.

๐Ÿ”’ Local Only
๐Ÿ“ต No Network
๐Ÿ“– Open Source

Skeptical? Copy the full script and ask ChatGPT or Claude to verify it's safe:

1

Open Terminal

Press โŒ˜ + Space, type "Terminal", hit Enter

2

Grant disk access

System Settings โ†’ Privacy & Security โ†’ Full Disk Access โ†’ click the + button โ†’ navigate to Applications/Utilities/Terminal

3

Download the script

Paste in Terminal and hit Enter, or download here:

curl -O https://raw.githubusercontent.com/kothari-nikunj/wrap2025/main/imessage_wrapped.py
4

Run it

Paste in Terminal and hit Enter:

python3 imessage_wrapped.py
1

Open Terminal

Press โŒ˜ + Space, type "Terminal", hit Enter

2

Grant disk access

System Settings โ†’ Privacy & Security โ†’ Full Disk Access โ†’ click the + button โ†’ navigate to Applications/Utilities/Terminal

3

Download the script

Paste in Terminal and hit Enter, or download here:

curl -O https://raw.githubusercontent.com/kothari-nikunj/wrap2025/main/whatsapp_wrapped.py
4

Run it

Paste in Terminal and hit Enter:

python3 whatsapp_wrapped.py
1

Open Terminal

Press โŒ˜ + Space, type "Terminal", hit Enter

2

Grant disk access

System Settings โ†’ Privacy & Security โ†’ Full Disk Access โ†’ click the + button โ†’ navigate to Applications/Utilities/Terminal

3

Download the script

Paste in Terminal and hit Enter, or download here:

curl -O https://raw.githubusercontent.com/kothari-nikunj/wrap2025/main/combined_wrapped.py
4

Run it

Paste in Terminal and hit Enter:

python3 combined_wrapped.py
๐Ÿ“ฑ๐Ÿ’ฌ Combined Mode
Merges stats from both iMessage and WhatsApp. Uses your AddressBook to reconcile contacts across platforms. Works even if you only have one platform installed.
1

Install Claude Code

Get Claude Code from claude.ai/code if you don't have it

2

Grant disk access

System Settings โ†’ Privacy & Security โ†’ Full Disk Access โ†’ add Terminal

3

Download the script

Paste in Terminal and hit Enter:

curl -O https://raw.githubusercontent.com/kothari-nikunj/wrap2025/main/people_wrapped.py
4

Start Claude Code

Run with permissions disabled (needed for 25 file writes):

claude --dangerously-skip-permissions
5

Run it in Claude Code

Type this in Claude Code:

Run python3 people_wrapped.py
๐Ÿค– AI-Powered Summaries
Claude Code reads your full message history and writes personalized summaries for your top 25 contacts. Includes direct quotes, inside jokes, and how the relationship evolved. Takes ~10 minutes.
1

Open Terminal

Press โŒ˜ + Space, type "Terminal", hit Enter

2

Grant disk access

System Settings โ†’ Privacy & Security โ†’ Full Disk Access โ†’ click the + button โ†’ navigate to Applications/Utilities/Terminal

3

Download the script

Paste in Terminal and hit Enter, or download here:

curl -O https://raw.githubusercontent.com/kothari-nikunj/wrap2025/main/call_wrapped.py
4

Run it

Paste in Terminal and hit Enter:

python3 call_wrapped.py
๐Ÿ“ž Call Stats
Analyzes your Phone calls, FaceTime, and WhatsApp calls. See who you call most, talk time, missed calls, and your calling personality. Mac keeps ~1000 recent calls.
โš ๏ธ Not enough 2025 messages? Use the --use-2024 flag.
๐Ÿ“Š
TOTAL MESSAGES
๐Ÿ‘‘
TOP 5 CONTACTS
๐Ÿง 
PERSONALITY
โฑ๏ธ
RESPONSE TIME
๐ŸŒ™
3AM BESTIE
๐Ÿ”ฅ
HEATING UP
๐Ÿ‘ป
GHOSTED
๐Ÿ˜
DOWN BAD
๐Ÿ“
WORD COUNT
โฐ
PEAK HOURS
๐ŸŽฏ
WHO TEXTS FIRST
๐Ÿ†
BIGGEST FAN
๐Ÿ‘ฅ
GROUP CHATS
๐Ÿ†
TOP GROUPS
๐Ÿ“…
CONTRIBUTION GRAPH