ccwrapdev
v0.9.2
Published
Your Claude Code stats, visualized and shared.
Readme
ccwrapdev
Your Claude Code stats, visualized and shared.
A social stats tracker for Claude Code. Run one command, auto-sync your usage, get a shareable profile and leaderboard ranking — with zero daily effort.
No sign-up, no auth required. Think Spotify Wrapped meets WakaTime — for Claude Code.
Quick Start
npx ccwrapdevThat's it. Scans your Claude Code logs, syncs stats to ccwrapped.dev, opens your profile, and installs auto-sync — all in one command.
View local stats only (no upload)
npx ccwrapdev --localCommands
| Command | Description |
|---|---|
| ccwrapdev | Scan logs, sync to ccwrapped.dev, open profile |
| ccwrapdev --local | Show local usage summary (offline, no upload) |
| ccwrapdev sync | Manual sync |
| ccwrapdev sync --minimal | Upload tokens only (no model/session data) |
| ccwrapdev setup | Enable auto-sync hook |
| ccwrapdev setup --check | Check if auto-sync is active |
| ccwrapdev setup --disable | Disable auto-sync hook |
| ccwrapdev card | Open your profile in browser |
| ccwrapdev card --copy | Copy profile URL to clipboard |
| ccwrapdev status | Show sync status and config |
| ccwrapdev auth --logout | Clear local state (preserves profile) |
| ccwrapdev auth --logout --hard | Reset account (wipe token + profile) |
Auto-Sync
On first run, ccwrapdev installs a Claude Code hook that syncs stats silently after every session. No action needed — it just works.
Manage it with:
ccwrapdev setup --check # is it active?
ccwrapdev setup --disable # turn it off
ccwrapdev setup # re-enableWhat Gets Uploaded
Only aggregated daily totals. Never your code, chats, file paths, or project names.
| Uploaded | NOT uploaded | |---|---| | Daily token counts | Your code | | Session count per day | Your conversations | | Model breakdown (Opus/Sonnet/Haiku) | File paths | | Estimated cost | Project names |
State is stored locally at ~/.config/ccwrapped/state.json (chmod 0600).
Requirements
- Node.js 20+
- Claude Code installed and used at least once
Links
- ccwrapped.dev — profiles and leaderboard
- GitHub — source code and issues
