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_DIR or ~/.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