phuryn

phuryn / claude-usage

Public

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.

www.productcompass.pm claude-code
606
91
100% credibility
Found Apr 09, 2026 at 606 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Python
AI Summary

A lightweight tool that reads local logs from Claude Code sessions to generate usage summaries, statistics, and an interactive web dashboard with charts and cost estimates.

How It Works

1
🔍 Discover the usage tracker

You hear about a simple tool that turns your AI coding session logs into easy-to-read charts and summaries to watch your usage and costs.

2
💾 Download the files

Grab the few small files from the sharing site and place them in a folder on your computer.

3
📂 Gather your session data

Run the checker once to pull together all your past AI coding activity from the usual log spots on your computer.

4
Pick your view
📱
Quick daily summary

See today's activity and totals right in your terminal window.

🌐
Interactive dashboard

Open a webpage on your computer showing colorful charts that update automatically.

5
📈 Wow, see the full picture!

Watch bars and lines show your token counts, models used, projects, and money spent in a glance.

🎉 Track usage happily

Now you always know how much you're using and spending, staying in control effortlessly.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 606 to 606 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is claude-usage?

Claude-usage is a Python-based local dashboard and CLI tracker for monitoring your Claude Code token usage, costs, and session history from local JSONL logs. It pulls data from Claude Code CLI, VS Code extension, and dispatched sessions to show input/output tokens, cache hits, model breakdowns, and API-priced cost estimates—giving Pro and Max users a progress bar for limits that Anthropic's UI hides. Run `python cli.py scan` to build the database, `today` or `stats` for terminal summaries, or `dashboard` for a browser-based view at localhost:8080 with auto-refresh charts.

Why is it gaining traction?

No pip installs or deps—just standard library Python, SQLite, and a lightweight HTTP server with Chart.js—means git clone and run in seconds, unlike heavier claude usage monitors. Incremental scans skip unchanged files for speed, custom project dirs work for Xcode integrations, and bookmarkable model filters make it a practical claude code usage github tool for daily checks. With 606 stars, devs grab it for the full picture on claude token usage github limits without cloud logins.

Who should use this?

Claude Pro/Max subscribers burning through sessions in VS Code or terminal who need a claude usage bar to avoid surprises. API devs tracking claude usage api costs across opus/sonnet/haiku models. Mac users with Xcode Claude integration wanting a claude usage mac github dashboard for project-level history.

Verdict

Grab it if you're deep in Claude Code—solid docs and zero-setup make this claude usage tracker github a no-brainer for 606-star traction, despite the 1.0% credibility score signaling early maturity. Test on a side project first; lacks tests but nails the niche.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.