GitHub - joey-io/gauge · GitHub
/" data-turbo-transient="true" />
Skip to content
Search or jump to...
Search code, repositories, users, issues, pull requests...
-->
Search
Clear
Search syntax tips
Provide feedback
--><br>We read every piece of feedback, and take your input very seriously.
Include my email address so I can be contacted
Cancel
Submit feedback
Saved searches
Use saved searches to filter your results more quickly
-->
Name
Query
To see all available qualifiers, see our documentation.
Cancel
Create saved search
Sign in
/;ref_cta:Sign up;ref_loc:header logged out"}"<br>Sign up
Appearance settings
Resetting focus
You signed in with another tab or window. Reload to refresh your session.<br>You signed out in another tab or window. Reload to refresh your session.<br>You switched accounts on another tab or window. Reload to refresh your session.
Dismiss alert
{{ message }}
joey-io
gauge
Public
Notifications<br>You must be signed in to change notification settings
Fork
Star
main
BranchesTags
Go to file
CodeOpen more actions menu
Folders and files<br>NameNameLast commit message<br>Last commit date<br>Latest commit
History<br>8 Commits<br>8 Commits
bin
bin
lib
lib
site
site
.gitignore
.gitignore
CLAUDE.md
CLAUDE.md
LICENSE
LICENSE
README.md
README.md
package.json
package.json
View all files
Repository files navigation
gauge
A local meter for your Claude Code plan. You pay a flat monthly price; gauge<br>shows you where it goes — by 5-hour window, day, model, and project.
npx github:joey-io/gauge
That's the whole install. It reads the session transcripts Claude Code already<br>writes to ~/.claude/projects, dedupes them down to real API messages, and<br>renders one screen:
your last 5 hours of spend against the biggest 5-hour window you've ever had
daily bars for the last 14 days
which models and which projects are eating the allowance
Nothing leaves your machine. No account, no telemetry, no network calls.
How it counts
Dollars are API-list-equivalent — what this usage would cost at<br>Anthropic's published API rates. Subscription plans don't publish their quota<br>mechanics, so this is the only honest common currency. It is not your bill.
Claude Code writes one transcript line per streamed chunk, all carrying the<br>same message id, and replays messages into new files when sessions resume.<br>gauge dedupes by message id; naive line-summing over-counts badly.
Subagent transcripts nest several directories deep. gauge walks them —<br>in testing they held roughly half the spend.
"Peak 5h window" is your observed ceiling, labeled as such. Anthropic doesn't<br>expose the actual plan limit.
Requirements
Node 22.5 or newer (uses the built-in sqlite — zero npm dependencies).<br>A Claude Code history at ~/.claude/projects.
Options
# register a license key (verifies offline)<br>GAUGE_DATA_DIR=... # move the cache db (default ~/.cache/gauge)">gauge --days 30 # widen the by-model / by-project sections<br>gauge activate # register a license key (verifies offline)<br>GAUGE_DATA_DIR=... # move the cache db (default ~/.cache/gauge)
The first run scans your full history (about a minute per GB of transcripts).<br>After that it's incremental and takes a second or two.
License
MIT.
About<br>No description, website, or topics provided.<br>Resources<br>Readme<br>MIT license<br>Activity<br>Stars<br>1 star<br>Watchers<br>0 watching<br>Forks<br>0 forks<br>Report repository
Releases
Packages
Contributors
Languages
You can’t perform that action at this time.