session-wrapped
Spotify Wrapped for a session: an animated stat reveal and a shareable PNG.
Illustration. Actual results depend on the mod, terminal and environment.
Install
/plugin marketplace add OneWave-AI/claude-code-mods
/plugin install session-wrapped@claude-code-mods
/reload-pluginsRun these commands one at a time in a Claude Code session.
claude plugin marketplace add OneWave-AI/claude-code-mods
claude plugin install session-wrapped@claude-code-modsThen run /reload-plugins in your session, or start a new session.
Please install the Claude Code mod "session-wrapped" (https://github.com/OneWave-AI/claude-code-mods). Before installing, read the Security and Requirements sections of its README and tell me what it reads and writes, which commands it runs, whether it uses the network, and which Claude Code version, OS and terminal it needs. If everything looks fine, run claude plugin marketplace add OneWave-AI/claude-code-mods and claude plugin install session-wrapped@claude-code-mods, then remind me to run /reload-plugins in my session.Send this to Claude Code so it reads the author’s instructions before installing.
git clone https://github.com/OneWave-AI/claude-code-mods
cd claude-code-mods
claude --plugin-dir ./session-wrappedClone the repository and try it in a local session with --plugin-dir.
What it accesses
Based on the author’s documentation, checked when listed; use claude plugin validate to check for yourself.
Reads
YesReads local transcripts in ~/.claude/projects.
Writes files
YesWrites one PNG to ~/Desktop and a cache in ~/.cache/session-wrapped.
Runs commands
YesRuns python3 to read transcripts and base64 to write the PNG.
Network
NoneIntroduction
session-wrapped is a usage mod from OneWave AI modeled on Spotify Wrapped. /wrapped plays an animated stat reveal for the session in a pane and then writes a 1200px PNG card to your Desktop for sharing.
- The reveal covers session length, tool calls, the MVP tool, red-to-green test runs, the longest turn and cost
- Week and month totals come from
scripts/usage.py, which reads local transcripts in~/.claude/projectsand caches the rollups
The author states it runs python3 to read local transcripts and base64 to write the PNG, writes one image to ~/Desktop and a cache in ~/.cache/session-wrapped, makes no network calls, calls no model, and nothing leaves your machine. Requires Claude Code 2.1.287+ and python3. Not run-tested by this site; the preview is illustrative.
Who it is for
- People who want a recap of a long session
- People who want a shareable image of their Claude Code stats
Requirements
- Claude Code ≥ 2.1.287
- Needs python3.