phuryn/claude-usage

Some data may be outdated — see provenance labels.

A local dashboard for tracking your Claude Code token usage, costs, and session history. Pro and Max subscribers get a progress bar. This gives you the full picture. observed · 2026-09-25

github.com/phuryn/claude-usage · homepage · Python · MIT (permissive) observed · 2026-09-25

Health v2 · maintenance only

70/100

Activity 83
Release rhythm 85
Longevity 14

How is this computed?

round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-10-21. Adoption (stars, forks) is never an input.

gap_med: 0
age_days: 196
days_rel: 102
days_push: 102
n_releases_24m: 16

Full methodology

Adoption not part of the score

2236 stars · 412 forks observed · 2026-09-25

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A local dashboard that parses Claude Code's local JSONL usage logs to show token usage, cost estimates, and session history via a web dashboard and CLI. It works across API, Pro, and Max plans and is also available as a VS Code extension.

Use cases

track my Claude Code token usage
estimate costs of my Claude Code sessions
see how much of my Claude Max quota I've used
view session history for Claude Code projects
monitor LLM API spend locally
dashboard for Claude Code usage logs

When to choose

you use Claude Code and want visibility into token consumption and costs beyond Anthropic's UI
you want a zero-dependency, local-only tool with no data leaving your machine
you want a quick install via Homebrew, pipx, or uv with a web dashboard

When to avoid

you need to track Cowork sessions, which run server-side and write no local logs
you need usage tracking for tools other than Claude Code
you need team-wide or cloud-synced usage analytics

Facets

cli-tool · maturity active

analytics data-visualization cli developer-tools monitoring developer-tools analytics large-language-models python cli cross-platform windows claude-code token-usage cost-tracking usage-dashboard llm-usage vscode-extension zero-dependency command-line macos linux docker

2 sources

readme: https://github.com/phuryn/claude-usage · fetched 2026-09-25 · 8fab60f77016
homepage: https://www.productcompass.pm/ · fetched 2026-08-29 · f0a4a8e4967e

Member repositories

Repository	Role	Health v2
phuryn/claude-usage	main	70

For agents

markdown · JSON · MCP: product_card(name="phuryn/claude-usage")

Data as of 2026-10-19T08:05:51.212177+00:00 · Report a problem