flukelaster

flukelaster / claude-usage

Public

Local dashboard for visualizing Claude Code token usage and estimated API costs

18
3
100% credibility
Found Apr 16, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

Local dashboard for viewing token usage, estimated costs, and analytics from Claude Code session logs on your computer.

How It Works

1
🔍 Discover the dashboard

You hear about a simple tool from Claude users that shows your chat usage and costs right on your computer.

2
💾 Get it on your computer

Download the files and start it up with a quick launch – no fancy setup needed.

3
🔄 Pull in your chat history

Click the sync button to grab your local Claude chat logs automatically.

4
📊 See your stats light up

Watch charts fill with your daily spending, top projects, and efficiency insights – it's like a personal finance app for AI chats.

5
🔍 Explore your usage

Switch between views for forecasts, peak times, models used, and what-if savings scenarios.

6
📄 Save a report

Export a polished PDF summary of your activity to share or review anytime.

✅ Master your AI spending

Now you clearly see where your tokens go, spot savings, and plan better – all privately on your machine.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 18 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 local dashboard built in TypeScript with TanStack Start, SQLite, and Tailwind that parses your Claude Code session logs from ~/.claude/projects/ to visualize token usage and estimated API costs. It pulls data like input/output tokens, cache reads/writes, and models used (Opus, Sonnet, Haiku), then displays interactive charts for daily trends, forecasts, peak hours, and efficiency metrics—no Anthropic API calls needed. Run `pnpm sync` to import logs, then `pnpm dev` for a browser-based Claude usage tracker with PDF exports and dark mode.

Why is it gaining traction?

Unlike cloud-based Claude token usage monitors or basic CLI tools like ccusage, this offers a polished airgradient-style local dashboard with unique views like "what-if" model cost simulations, cache hit rate ROI, and GitHub-style activity heatmaps. Developers love the incremental sync for huge log folders, budget trackers, and per-project/session breakdowns that reveal CLI vs. VS Code efficiency. It's a zero-network Claude usage bar and limits dashboard tailored for heavy local coding sessions.

Who should use this?

Claude Code power users on macOS, Linux, or Windows tracking token burn across projects, especially Max subscribers estimating "unlimited" costs via logs. Frontend/backend devs optimizing model choices, teams auditing cache savings, or anyone hitting Claude usage limits Reddit-style who wants a claude-usage-tool beyond spreadsheets.

Verdict

Solid early pick for Claude code usage GitHub monitoring—installs fast, docs shine, MIT license—but with 10 stars and 1.0% credibility score, treat it as alpha for production. Sync your logs today if you're deep in Claude Code; fork and contribute to push it forward.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.