@uxcontinuum/ccwrapped 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +92 -0
  2. package/index.js +749 -0
  3. package/package.json +33 -0
  4. package/wrapped.py +1171 -0
package/README.md ADDED
@@ -0,0 +1,92 @@
1
+ # Claude Code Wrapped
2
+
3
+ Spotify Wrapped, but for your Claude Code sessions.
4
+
5
+ Reads your local `~/.claude/projects/` directory. Nothing leaves your machine. Takes about 3 seconds to run.
6
+
7
+ ## What you get
8
+
9
+ ```
10
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
11
+ YOUR CLAUDE CODE WRAPPED
12
+ last 30 days
13
+ ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
14
+
15
+ 🔥 YOUR BIGGEST NUMBER
16
+
17
+ 17,706 sessions with Claude in the last 30 days.
18
+
19
+ 📍 WHERE YOU LIVED
20
+
21
+ Your most active project was clawd-gtm — 847 sessions
22
+ across 23 total projects.
23
+
24
+ ⚡ YOUR WEAPON OF CHOICE
25
+
26
+ Bash — you reached for it 71% of the time.
27
+
28
+ 🧠 TOKENS BURNED
29
+
30
+ Claude generated 76.4M output tokens for you.
31
+ That's 169x the word count of Lord of the Rings.
32
+
33
+ 🌙 YOU'RE A NIGHT OWL
34
+
35
+ 24% of your sessions started after 10pm.
36
+
37
+ 🧬 YOUR ARCHETYPE
38
+
39
+ THE BASH HAMMER
40
+ You don't read docs. You run things and see what breaks.
41
+
42
+ ✦ SECONDARY TRAIT: THE JUST-ER
43
+
44
+ You said "just" 103 times. Just do it. Just fix it.
45
+ ```
46
+
47
+ ## Install
48
+
49
+ Requires Python 3.9+. No dependencies.
50
+
51
+ ```bash
52
+ git clone https://github.com/turleydesigns/claude-wrapped
53
+ cd claude-wrapped
54
+ python3 wrapped.py
55
+ ```
56
+
57
+ ## Options
58
+
59
+ ```bash
60
+ python3 wrapped.py # Spotify Wrapped — stats + archetype slide
61
+ python3 wrapped.py --archetype # full personality card — famous for, strength, watch out
62
+ python3 wrapped.py --roast # personalized roast from your actual session data
63
+ python3 wrapped.py --dna # your prompt style DNA — formality, verbosity, style, one-liner
64
+ python3 wrapped.py --tune-up # generate CLAUDE.md suggestions from your patterns
65
+ python3 wrapped.py --tune-up --write # write those suggestions directly to CLAUDE.md
66
+ python3 wrapped.py --days 7 # just this week
67
+ python3 wrapped.py --days 365 # full year
68
+ python3 wrapped.py --no-color # plain text for copying
69
+ ```
70
+
71
+ ## Archetypes
72
+
73
+ Your archetype is derived from your actual tool usage ratios:
74
+
75
+ | Archetype | What triggers it |
76
+ |-----------|-----------------|
77
+ | The Bash Hammer | Bash > 55% of tool calls |
78
+ | The Detective | Grep + Read + Glob > 50% |
79
+ | The File Surgeon | Edit + Write > 40% |
80
+ | The Orchestrator | Agent calls > 10% |
81
+ | The Night Owl | 35%+ of sessions after 10pm |
82
+ | The Essayist | Average prompt > 600 chars |
83
+ | The Commander | Average prompt < 80 chars |
84
+ | The Generalist | No dominant pattern |
85
+
86
+ ## How it works
87
+
88
+ Reads `~/.claude/projects/**/*.jsonl`. Each file is a session conversation. Parses tool call types, timestamps, user message text, and token usage. No API calls. No network. Fully offline.
89
+
90
+ ---
91
+
92
+ Built by [Matt Turley](https://uxcontinuum.com) · [RelayPlane](https://relayplane.com) for full agent session analytics