benwaffle/claude-stats
skills/claude-stats/SKILL.md
Generate an interactive HTML report of your Claude Code usage (sessions, messages, tokens, active days, streaks, peak times, model usage by day, top projects/tools) by parsing ~/.claude/projects/*.jsonl. Use when the user asks for their Claude stats, usage, activity, streaks, token breakdown, or wants to see how they use Claude over time.
tools
Updated Apr 20, 2026
$ install --global
skillsauthnpx skillsauth add benwaffle/skills claude-statsInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 20, 2026, 3:15 AM5.9s2 files scanned
SKILL.md
- name:
- claude-stats
- description:
- Generate an interactive HTML report of your Claude Code usage (sessions, messages, tokens, active days, streaks, peak times, model usage by day, top projects/tools) by parsing ~/.claude/projects/*.jsonl. Use when the user asks for their Claude stats, usage, activity, streaks, token breakdown, or wants to see how they use Claude over time.
- user-invocable:
- true
claude-stats
Builds a single self-contained HTML report from the user's local Claude Code conversation logs.
How to run
python3 "${CLAUDE_PLUGIN_ROOT:-$(dirname "$0")}/build_stats.py" [OUTPUT_HTML] [CLAUDE_DIR]
OUTPUT_HTML— where to write the report. Defaults to./claude_stats.html.CLAUDE_DIR— Claude config directory. Defaults to$CLAUDE_DIRor~/.claude.
The script writes a sidecar .json next to the HTML (same basename) for debugging or re-use.
After running, open the HTML in the browser: open <output_html> (macOS) or xdg-open (Linux).
What it reports
- Totals: sessions, user/assistant messages, tokens (input/output/cache-create/cache-read).
- Timeline: daily activity, token usage over time.
- Model usage by day (stacked bar, one color per model).
- Peak hours + peak weekdays, hour×weekday heatmap.
- Streaks: longest + current (computed over all time, not the current filter).
- Top projects, top tools, top models.
- Session table sortable by duration / messages / tokens.
Interactive filtering
The report has a filter bar: All time · By month · By week · Last 30d · Last 7d. Selecting By month or By week reveals clickable chips (one per bucket, showing its message count). All charts, cards, and tables rescope to the selection.
Streaks intentionally stay all-time — streak length inside a single week is meaningless.
Data source notes
- Scans every
*.jsonlunder<CLAUDE_DIR>/projects/recursively (includes subagent logs). - Timestamps are converted to local time for hour-of-day / weekday bucketing.
- Excludes
<synthetic>assistant messages from model tallies (they have no real usage). - Distinguishes genuine user prompts from tool-result blocks (both have
type: "user"but tool results aren't counted as user messages). - Tool usage is counted per
tool_useblock in assistant messages.
Typical invocation pattern
When the user asks for "my Claude stats" or "usage report":
- Run the script to a temp path, e.g.
/tmp/claude_stats.html. - Summarize the top-level numbers in chat (sessions, messages, tokens, active days, streaks, peak hour/weekday).
openthe HTML so the user can explore interactively.
The report is fully client-side — Chart.js is loaded from jsdelivr CDN. No data leaves the machine.
Related Skills
benwaffle/slack-copy
tools
VerifiedTrustedCommunity
Put formatted content on the macOS clipboard so it renders correctly when pasted into a Slack message composer (bold/italic/lists via HTML, tables via TSV).
SKILL.mdUpdated May 24, 2026
benwaffle/slideshow
development
VerifiedTrustedCommunity
Generate self-contained HTML slideshows for technical concepts with diagrams, code highlighting, math, and charts
SKILL.mdUpdated Apr 20, 2026
benwaffle/apple-logarchive
databases
VerifiedTrustedCommunity
Query and analyze Apple .logarchive files using the macOS `log show` command
SKILL.mdUpdated Apr 20, 2026
benwaffle/adb
development
VerifiedTrustedCommunity
Android Debug Bridge (ADB) assistant for inspecting, debugging, and managing Android devices
SKILL.mdUpdated Apr 20, 2026