claude-stats

Claude Status Check — analyze your Claude usage and get an MMORPG-style character sheet: a radar chart of 6 stats, a character class, and a level.

A hobby project. No server, no accounts, no tracking. Everything runs on your machine or in your browser.

Quick start

Path 1 — Claude Code users (CLI)

npx claude-character-sheet
# or straight from GitHub (no npm):
npx github:MankhongGarden/claude-stats
# pin to an immutable release for reproducibility:
npx github:MankhongGarden/claude-stats#v1.0.0

Scans your local Claude Code transcripts (~/.claude/projects or $CLAUDE_CONFIG_DIR/projects), prints a terminal stat card, and gives you a share URL that opens the web card.

Flags:

| flag | effect | |---|---| | --json | raw JSON output, no card | | --no-share | skip the share URL | | --dir <path> | use a custom transcripts directory | | --help | usage |

Path 2 — claude.ai users (web upload · beta)

Open the web page and drop your claude.ai data export (conversations.json) onto it:

https://mankhonggarden.github.io/claude-stats/

How to get the file: claude.ai → Settings → Privacy → Export data → the file arrives by email.

Beta note: the claude.ai export parser is written against the publicly documented export shape but has not been validated against every real export. If your file is not recognized, please open an issue — ideally describing the top-level structure (no need to share any conversation content).

Privacy model

• CLI: transcripts are read locally and never leave your machine. Only the 6 aggregate scores plus three totals (sessions, tool calls, message count) are encoded into the share URL hash — the level shown on the card is derived from those totals. Nothing else travels.
• Web upload: conversations.json is parsed entirely in your browser (client-side JavaScript). There is no backend and no upload endpoint — there is nowhere for the file to go.
• Share URL: contains only the aggregated numbers (6 scores + 3 totals), base64url-encoded in the #s= hash. Anyone with the link sees your stat card, never your conversations.
• The web app vendors its JS libraries locally — opening the page makes no third-party API calls except Google Fonts (CSS only).

How scoring works

Each tool call (CLI) or message heuristic (web) is classified into one of 6 axes:

| axis | what it measures | example signals (CLI) | |---|---|---| | AUTOMATOR | agents, workflows, shell automation | Agent, Task, Workflow, Bash, PowerShell | | RESEARCHER | searching and reading | WebSearch, WebFetch, Read, Grep, Glob | | CODER | writing and editing real files | Edit, Write, NotebookEdit | | INTEGRATOR | external services via MCP | any other mcp__* tool | | WRITER | prose output volume | assistant text chars / 4000 | | PILOT | driving a real browser | chrome-devtools / playwright MCP tools |

CLI uses fixed anchors so two Claude Code users' cards are directly comparable: score = min(100, round(100 * sqrt(x / REF))) — a square-root curve, so early activity climbs fast and the top end is hard to max.

REF anchors (what 100 means on the CLI path), v1:

| axis | REF (CLI units) | |---|---| | automator | 25000 | | researcher | 15000 | | coder | 15000 | | integrator | 8000 | | writer | 4000 | | pilot | 4000 |

Web uses self-relative shape scoring instead: your strongest axis is the reference (100) and the rest are proportional ((x / max) ^ 0.7). Volume is carried by the level, not the axis heights — so a casual user still gets a full, varied radar (like an RPG class whose stat shape is the same at level 5 and level 50), rather than a flat low card. Web axes are counted from your own messages (what you ask for), never from how much Claude wrote back. The web card is a rough estimate and is not comparable to a CLI card.

Honest calibration note: the CLI anchors are derived from a single heavy daily user's corpus (~426 sessions / ~57k tool calls, snapshot 2026-06-12) — one data point, not a population study. Expect recalibration in later versions.

Level: floor(sqrt(effort / 25)), where effort = total tool calls (CLI) or total messages × 4 (web). Minimum level 1.

Character classes

Your top axis decides your class (ties break by axis order):

| top axis | class | |---|---| | automator | Fleet Commander — ผู้บัญชาการกองทัพ AI | | researcher | Lore Hunter — นักล่าความรู้ | | coder | Code Smith — ช่างหลอมโค้ด | | integrator | Realm Linker — ผู้เชื่อมทุกอาณาจักร API | | writer | Chronicle Keeper — ผู้จดบันทึกแห่งยุค | | pilot | Web Navigator — นักบินผู้พิชิตทุกหน้าเว็บ |

FAQ

Why is my level low? Levels follow a square-root curve against total volume — they're meant to climb slowly. The anchors are calibrated against a very heavy user, so a "normal" usage pattern landing at level 5–15 is expected, not a bug.

Does this upload my chats anywhere? No. There is no server. CLI parsing happens on your machine; web parsing happens in your browser. The only thing that ever travels is the share URL you choose to copy, which contains 6 scores + 3 totals (sessions, tool calls, message count) — never message text.

The web upload says my file format isn't recognized. The claude.ai parser is beta. Export formats can change. Please open an issue with a description of the file's top-level structure.

Can I compare with friends? CLI cards compare to CLI cards — scores use fixed anchors (not self-relative), so two Claude Code users' cards are directly comparable. The web (claude.ai) card is a rough text-inferred estimate and is not comparable to a CLI card; the CLI / WEB · BETA badge next to the level tells you which kind you're looking at.

สรุปภาษาไทย

Claude Status Check — เช็คสถานะการใช้ Claude ของคุณ แล้วได้การ์ดตัวละครสไตล์เกม MMORPG: กราฟเรดาร์ 6 ค่าพลัง + คลาส + เลเวล

2 ทางเข้า:

• สาย Claude Code: รัน npx github:MankhongGarden/claude-stats ใน terminal — สแกน transcript ในเครื่อง พิมพ์การ์ดสรุป + ลิงก์แชร์
• สาย claude.ai (เบต้า): ไปที่ https://mankhonggarden.github.io/claude-stats/ แล้วลากไฟล์ conversations.json (ขอ export ได้ที่ Settings → Privacy → Export data ไฟล์มาทางอีเมล) — ตัวอ่านไฟล์ยังเป็นเวอร์ชันเบต้า ถ้าไฟล์อ่านไม่ได้ช่วยเปิด issue บอกหน่อย

ความเป็นส่วนตัว: ข้อมูลบทสนทนาไม่ออกจากเครื่องเลย — CLI อ่านไฟล์ในเครื่อง ส่วนหน้าเว็บอ่านไฟล์ในเบราว์เซอร์เท่านั้น ไม่มี server ไม่มีการอัปโหลด สิ่งเดียวที่อยู่ในลิงก์แชร์คือเลขคะแนนรวม 6 ค่า

คะแนน: คิดจากปริมาณการใช้งานจริงเทียบกับค่าอ้างอิงคงที่ (สูตร square root) เทียบข้ามคนได้ · ค่าอ้างอิง v1 มาจากข้อมูลผู้ใช้หนัก 1 คน อาจปรับใหม่ในเวอร์ชันถัดไป

โปรเจกต์งานอดิเรก ฟรี โอเพนซอร์ส (MIT)