claude-code-insights 0.1.0

Local session-history browser, token/cost analytics, and productivity insights for Claude Code.

◆ claude-code-insights

Turn your Claude Code session history into a browsable dashboard — with token, cost, and productivity analytics. 100% local.

---

claude-code-insights reads the .jsonl transcripts Claude Code already keeps under ~/.claude/projects/, builds a single self-contained claude_insights.html you open in any browser, and prints a quick summary to your terminal. No server, no upload, no account.

Claude Insights — 128 sessions · 14 projects
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Est. tokens:     678K input · 388K output
Est. cost:       ~$13.08  (Opus pricing)
Top tool:        Bash (621 calls)
Busiest day:     2026-06-23 (52 prompts)
Longest session: Refactor auth flow (4h 12m)

Three views

View	What you get
🗂️ History	Search and filter every session, read full conversations, and export one or all of them to Markdown, CSV, JSON, HTML, or plain text.
📊 Analytics	Estimated token usage and cost, cost-by-project and tool-usage charts, input/output token ratio, your most expensive sessions, and automatic insights (cost spikes, tool-heavy or very long sessions, streaks).
🔥 Productivity	Prompts-per-day trend, an hour-by-day activity heatmap, current/longest streaks, busiest projects, prompt-length distribution, session durations, and clustering of repeated prompt patterns.

Install

pipx install claude-code-insights        # recommended
# or
uvx claude-code-insights                 # run without installing
# or
pip install claude-code-insights         # into the current environment

For more accurate token counts (uses tiktoken):

pipx install "claude-code-insights[tokens]"

Usage

claude-insights              # write claude_insights.html + print a summary
claude-insights --open       # also open the report in your browser
claude-insights --cli-only   # terminal summary only, skip the HTML
claude-insights --dir PATH   # use a custom projects directory
claude-insights --out FILE   # custom HTML output filename
claude-insights --version

You can also run it as a module: python3 -m claude_insights --open.

Privacy

Everything runs on your machine — nothing is uploaded anywhere. The generated HTML embeds your prompts and responses, which may contain file paths, code, and secrets. Review the file before sharing it with anyone.

A note on cost figures

Cost numbers are estimates, not real API charges. They multiply estimated token counts by Claude Opus pricing ($5 / $25 per 1M input / output tokens) — your actual model and rates may differ. Treat them as a relative signal, not a bill.

Development

git clone https://github.com/pragnesh12/claude-code-insights
cd claude-code-insights
pip install -e ".[tokens]"
claude-insights --help

License

MIT · An unofficial tool — not affiliated with or endorsed by Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic.