session-wrapped

Reviewed at commit 00e7142

/wrapped plays an animated recap of the session and writes a shareable PNG card, with week and month totals read from local transcripts.

Made by
OneWave AI
What we checked

Counts tool calls, files edited, test runs, turns and cost during the session, and /wrapped shows them as an animated reveal and saves a PNG card to your Desktop. A bundled Python script also reads your local Claude Code transcripts to total week and month usage and caches counts in ~/.cache. Nothing is sent over the network.

Review details

Static review of the source at the pinned commit; not run. Registers /wrapped (optionally 'demo') and hooks session.start, prompt.submit (turn start time only), tool.call (runs the call unchanged with next(e), then counts tool name, edited file path, whether a Bash command looks like a test run, skill and MCP connector name), turn.complete, session.end (toast) and ui.render. Counters are kept with $.state. On session start and on /wrapped it runs python3 scripts/usage.py, which walks ~/.claude/projects/**/*.jsonl for the last 30 days, parses each record locally and keeps only per-day counts (prompts, session ids, tokens, model, tool, skill and connector names), cached in ~/.cache/session-wrapped/usage-v3.json; prompt text is read only to count and to spot slash command names. The PNG card is drawn in-process and written to ~/Desktop/claude-wrapped-<time>.png via the system base64 decoder, with scripts/write_b64.py as fallback; the card shows aggregates and the most-edited file's base name. No network, no model calls, no code download.

What it uses
  • Reads your prompts: yes
  • Sees tool calls: yes
  • Blocks or changes tool calls: no
  • Reads or writes files: yes
  • Runs programs on your machine: yes
  • Calls the model (uses tokens): no
  • Sends data over the network: no
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Screenshot of session-wrapped

Spotify Wrapped for a Claude Code session: an animated stat reveal and a shareable PNG card

Made this mod? Add a badge to your README

modsforClaude badge for session-wrapped

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/session-wrapped.svg)](https://modsforclaude.com/mods/session-wrapped/)

← All mods