Show HN: Claude Code Usage Monitor – real-time tracker to dodge usage cut-offs

https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor

89•Maciej-roboblog•5h ago

I kept slamming into Claude Code limits mid-session and couldn’t find a quick way to see how close I was getting, so I hacked together a tiny local tracker.

Streams your prompt + completion usage in real time

Predicts whether you’ll hit the cap before the session ends

Runs 100 % locally (no auth, no server)

Presets for Pro, Max × 5, Max × 20 — tweak a JSON if your plan’s different

GitHub: https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor

It’s already spared me a few “why did my run just stop?” moments, but it’s still rough around the edges. Feedback, bug reports, and PRs welcome!

Comments

pbowyer•5h ago

With uv, is there a way to install Python and Node tools like this in a self-contained way so they appear to the system as a single executable?

I guess I don't want to duplicate Python/Node for every tool, but I also don't want it to be fragile. And this wants a Node CLI tool installed globally, which I've found breaks easily with changing versions.

Maciej-roboblog•5h ago

Good point, yes i can do it. If you can please add issue in github and i will implement it :D

Maciej-roboblog•57m ago

it is on my todo list

JimDabell•4h ago

> I don't want to duplicate Python/Node for every tool

`uv tool install` doesn’t duplicate Python for every tool.

Maciej-roboblog•5h ago

Today, I will commit a new Auto Mode (with DuckDB) that uses machine learning to understand your actual token limits, not hardcoded solution.

alFReD-NSH•4h ago

How it does it monitor usage?

Maciej-roboblog•4h ago

Check directory ~/.claude/projects/*/*.jsonl ;) hah very interesting topic. I have a plan to write blog post about it (all conversations history with metadata inside json lines files) What do you think about this idea? Interesting?

M4v3R•4h ago

Wow, I had no idea Claude Code had this kind of verbose logging turned on by default. Looking around I also found a cool tool for converting these logs to HTML format for easy viewing: https://github.com/daaain/claude-code-log

Maciej-roboblog•4h ago

Haha, in that case it sounds like an article I could actually handle. By the way, is it better to go with an article or short-form video?

pbowyer•4h ago

Film video, transcribe, edit to become article?

I'm of an age where I rarely watch short-form videos so would read the article but you'll miss an audience if that's all you produce.

Maciej-roboblog•2h ago

Okay, sounds good — if I manage to do it, I’ll send you a message

Hortinstein•4h ago

Is there anyway to ensure these logs are output in a current project folder? Would like to store a copy in git for reference

Maciej-roboblog•2h ago

Yes in next relesase with duckdb, We will have the possibility of a simple export

alFReD-NSH•3h ago

It's definitely interesting. Probably, one could also see how much of the context is unnecessary to optimise usage. I wonder if one could also detect whether cache was used.

Maciej-roboblog•2h ago

Yes, cache write and read is available to fetch i can add new flag to view this values, please create issue in repository with this idea https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor...

soco•4h ago

I keep the credits page open and refresh it from time to time, because I honestly only care about money, not about tokens whatever these are.

Maciej-roboblog•2h ago

This tool is for plans with a fixed cost — like Pro Max x5 or x10 — not for API usage.

ed_mercer•4h ago

Thank you! For me, I wish it was just a simple command that outputs how much I have used out of my plan already. Also I feel it’s a bummer that I need python when CC is a node.js tool.

Maciej-roboblog•58m ago

I will update it in next release :D And you will be able to install the package directly.

teekert•4h ago

Claude is cool, they focus on cool and useful things.

But man do I just want a way to quickly glance at my API credits and to just occasionally chat with a model from those credits without librechat of openwebui. Or set some limits, or see some usage metrics.

And please please use "forever auth" with passkeys or something, what is up with that auth email that just takes ages for a quick glance?! It always takes me 3 attempts to find what address I used at sign-up...

Oh and make it clearer why you have that API/credits system and a subscription, why is it so difficult to understand when you start using Claude that it's 2 different unrelated worlds?? First time I started my subscription I just couldn't figure out where the API section was, until I realized it just wasn't there.

I feel like I'm "holding it wrong", but please make it easier to hold it right then.

redrove•3h ago

>And please please use "forever auth" with passkeys or something, what is up with that auth email that just takes ages for a quick glance?! It always takes me 3 attempts to find what address I used at sign-up...

As a person with the simple but brilliant technology of a freaking password manager, I LOATHE email to login/no-password websites. They are dreadful, we've somehow managed to come up with something worse in UX rather than move forward.

If you're working on a product that does this, or wants to do this, please please PLEASE reconsider, it's such a PITA for technical users and normies alike.

teekert•3h ago

Yeah, it's the reason I eventually tuned out of Slack too (obviously I don't use it day to day). I used it for some things, some community stuff, every now and then.

So when I open it up on a new machine or after months, you have to go through that magic link bs multiple times! For all your accounts/channels! I did that 2 or 3 times and then I just stopped using it.

I don't even remember what I signed up for over the years, I know some of it was nice (like an LoRa IOT channel, an "AWS professionals" channel, I set something up for the LoRaWan network in the previous city I lived in... All just tuned out because of the login bs.

sokoloff•3h ago

I don’t get why Slack can’t figure out how to help me migrate all my workspaces on a device I still have and am logged into in a new one in fewer than 3 steps per workspace. Sure, if I’ve lost all devices with the workspaces connected, maybe it needs to be that much PITA, but it’s a pretty common case to add/switch to a new machine or device and that process is obnoxiously poorly executed right now.

threeducks•3h ago

Another reason to ditch email-to-login: It decreases active user count because login is such a chore. I only use those websites if I absolutely have to and there are no alternatives.

rtsil•2h ago

I used to think the same thing, and I still want a login/password alternative for me. But after seeing normies use online accounts and the trouble they have with password managers, I realized one of my friends had the most secure process: she would create extremely high-entropy passwords everywhere, but not remember them. Once she's logged out of her sessions after a couple of months, she uses the password forgotten link to generate another password, and so on. So her passwords are never stored anywhere, she's immune to many login stealing phishing attempts through genuine-looking fake websites as she can't enter the password, she doesn't have to deal with syncing the passwords between all her devices, and she doesn't have passwords on a post-it on her workstation. And she also doesn't get those annoying emails saying "your password is 6-months old, please change it or else!".

The email auth flow is a simplified and more efficient way to achieve the same outcome.

dietr1ch•2h ago

yeah, I find it annoying, but it's a simple way of making something secure, piggyback on something that already made a decent effort at trying to being secure enough.

Maciej-roboblog•2h ago

I can write a blog post about this, plus in the next release, DuckDB will be implemented along with a slightly more advanced max tokens algorithm.

mellosouls•3h ago

For cursor users, a similar extension to monitor usage:

https://github.com/Dwtexe/cursor-stats

Maciej-roboblog•57m ago

Probably for API cost. It is for fixed price plans usage

hombre_fatal•3h ago

Anyone else have a bunch of fun with Claude Code's Github integration... until you realized it spends from your API wallet balance?

Oops, when I saw the /install-github-app command, I assumed that since I'm on a max plan and Claude Code in my terminal is free, then the Github integration would be free.

So I hooked it up to my repo and tagged @claude in everything. It was a lot of fun tagging it in backburner issues and seeing it solve issues I couldn't be bothered to do for years. Or just seeing what it would come up with on really low effort poorly explained issues.

But not worth spending 50+ cents every time.

sokoloff•3h ago

On one hand, it violated the principle of least surprise.

On another hand, you solved several years-old issues for under $50…which seems like a big win.

shmoogy•2h ago

You can use your max plan ( https://github.com/grll/claude-code-action )

Currently in gray area but allowed as per anthropic comment on it - https://github.com/anthropics/claude-code-action/issues/4#is...

hombre_fatal•2h ago

Oh, thanks! You didn't go digging that up just for me, did you?

I'll try it out right now.

csomar•1h ago

> Anyone else have a bunch of fun with Claude Code's Github integration... until you realized it spends from your API wallet balance?

Isn't Claude and Anthropic API two separate platforms? How does it spend from your other account?

hombre_fatal•1h ago

No.

https://console.anthropic.com/settings/billing

csomar•1h ago

What's that link supposed to show? It shows my anthropic account and billing. My claude account and billing (with different payment details) is at https://claude.ai/settings/billing

mwigdahl•55m ago

Addressing those issues wasn't worth $0.50 apiece? That almost certainly translates into less than a _minute_ of fully loaded engineering cost from a human.

waynenilsen•3h ago

they really should integrate this kind of thing, it is very annoying

Maciej-roboblog•57m ago

thx

bilekas•2h ago

This is pretty cool.. I like the idea, could I make a semi-snarky feature request and could we add the estimated power consumed to produce results for each session ?

TypingOutBugs•2h ago

Soon we will have low carbon developers

btbuildem•2h ago

We all were low carbon developers once

cdurth•1h ago

Maybe the few that were WFH prior to AI. I just calculated my carbon output for commuting and going to lunch daily versus WFH and using AI and it's wayyy less. Let's all save earth, stay home and use AI.

ozim•1h ago

Let's start with npm and node_modules first - I think it is responsible for at least half of the global warming.

Maciej-roboblog•2h ago

Greta would be proud, but I’m not sure how the number of tokens relates to energy consumption.

actsasbuffoon•1h ago

Soon the AI companies will have different tiers of plan based on carbon output.

For $200 per month they’ll only use carbon-free power sources for your prompts. At $100 they’ll use nuclear, then $20 per month for coal, and then there will be a free tier where your prompts are powered by throwing baby seals into a furnace.

Maciej-roboblog•59m ago

Lerc•30m ago

This may be pedantic, but I'm guessing baby seals are a renewable resource.

bilekas•27m ago

It would be on the same level as saying burning wood for power plants would be considered renewable. Is it "Green" now.. Two different things.

tln•1h ago

Or just straight to CO2. Google said 1000 tokens emits 8.3g CO2.

How many tokens used in a heavy vibe coding day?

Average US daily per capita is like 40kg CO2

KMnO4•1h ago

I don’t understand the concern of this. Let’s say it says you’ve used 1.521kg of CO2 today. How is that actionable?

A single flight from JFK to LAX produces around 20,000kg of CO2. Using the 8.3g value means a flight is equivalent to 2.41 billion tokens.

notarobot123•1h ago

if you take the long view, flying is irrational too

Maciej-roboblog•1h ago

If you have some time, feel free to open a pull request — even just with a description or clarification of what's going on! It all sounds super interesting, but I’m still trying to fully grasp the business logic behind it Once I get the idea, I’ll be happy to jump in and implement it.

Repo is here if you're curious: https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor...

taosx•1h ago

I really dislike when people don't see this. They try to cut 10 grams of CO2 per day while other industries (shipping, aviation, rails) produce hundreds of tons per day and even this transportation modes are less that 20% with most CO2 produced mainly being in energy production and used by industry.

bilekas•24m ago

It doesn't necessarily need to be actionable for now but at the moment there is an exponential growth in the datacenter power usages.

For now, sure it might be ridiculously minor, but when it starts to ramp up who's to say it wont be just a ridiculous amount of energy ? Maybe not even measure the CO2, but I would love to graph the increase of energy spent over time.

jbentley1•2h ago

This is great. I built a UI tool to run simultaneous Claude Code sessions (https://github.com/stravu/crystal) but by working on multiple features at once I hit the limits of my max account. Usually close to the reset, but it would be nice to know when it is time to take a break.

Maciej-roboblog•2h ago

Please write for me on github or create issue https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor... and we can try integrate your tool with usage monitor

rgoodwintx•42m ago

Kudos! I was just thinking about having. Laude write something like this for me. Not just within a project but the 5 different ones I have open at the same time. Too much of a good thing etc.

diego_moita•2h ago

Is there something similar to this but for Gemini?

Maciej-roboblog•2h ago

I can implement tool like this for Gemini, please create issue https://github.com/Maciek-roboblog/Claude-Code-Usage-Monitor... with this idea

loufe•1h ago

I really like this idea as I find Claude's transparency frustrating. Claude code's killer features revolve around better tools to manage context and limits vs the desktop app (compact and the % remaining until auto compact), but it's not enough.

If I can offer any advice, it's that the high use of emojis in a project readme (at least for me) looks so unprofessional and makes me worry that a project was vibe -coded in the sense that the AI was possibly not babysat to the extent I think they should. That's just me, though

oc1•1h ago

I got into software in a time where you would get sent to a mental institution when spotted using emojis in a code base. Times have changed.. I use emojis regularly because they help me organize context more visually. Code has now many emojis to keep me happy.

Maciej-roboblog•1h ago

This code was written in pure vibe-coding style — mostly for fun. I've got about 10 years of experience in IT, and even I fully agree: a 1000-line main file like this one probably deserves to be locked away in a secure facility.

But hey — if it's stupid and it works, it ain't stupid.

Posit floating point numbers: thin triangles and other tricks (2019)

Curved-Crease Origami Sculptures

Andrej Karpathy: Software in the era of AI [video]

Finding Dead Websites

From LLM to AI Agent: What's the Real Journey Behind AI System Development?

Guess I'm a Rationalist Now

In-Memory C++ Leap in Blockchain Analysis

Show HN: A DOS-like hobby OS written in Rust and x86 assembly

Show HN: Unregistry – “docker push” directly to servers without a registry

Show HN: Claude Code Usage Monitor – real-time tracker to dodge usage cut-offs

Painting with Math: A Gentle Study of Raymarching

Getting Started Strudel

Elliptic Curves as Art

What Would a Kubernetes 2.0 Look Like

Researchers are now vacuuming DNA from the air

My iPhone 8 Refuses to Die: Now It's a Solar-Powered Vision OCR Server

Show HN: Workout.cool – Open-source fitness coaching platform

A Visual Guide to Genome Editors

The Missing 11th of the Month (2015)

Base44 sells to Wix for $80M cash

Bento: A Steam Deck in a Keyboard

3D printable 6" f/5 compact travel telescope model

The Zed Debugger Is Here

Show HN: I made an app that lets you save audio to your Cameral Roll

The unreasonable effectiveness of fuzzing for porting programs

TI to invest $60B to manufacture foundational semiconductors in the U.S.

Microsoft wants you to buy a new computer. Make your current one secure again?

CPU-Based Layout Design for Picker-to-Parts Pallet Warehouses

Websites are tracking you via browser fingerprinting

SpaceX Starship 36 Anomaly

Show HN: Claude Code Usage Monitor – real-time tracker to dodge usage cut-offs

Comments

Posit floating point numbers: thin triangles and other tricks (2019)

Curved-Crease Origami Sculptures

Andrej Karpathy: Software in the era of AI [video]

Finding Dead Websites

From LLM to AI Agent: What's the Real Journey Behind AI System Development?

Guess I'm a Rationalist Now

In-Memory C++ Leap in Blockchain Analysis

Show HN: A DOS-like hobby OS written in Rust and x86 assembly

Show HN: Unregistry – “docker push” directly to servers without a registry

Show HN: Claude Code Usage Monitor – real-time tracker to dodge usage cut-offs

Painting with Math: A Gentle Study of Raymarching

Getting Started Strudel

Elliptic Curves as Art

What Would a Kubernetes 2.0 Look Like

Researchers are now vacuuming DNA from the air

My iPhone 8 Refuses to Die: Now It's a Solar-Powered Vision OCR Server

Show HN: Workout.cool – Open-source fitness coaching platform

A Visual Guide to Genome Editors

The Missing 11th of the Month (2015)

Base44 sells to Wix for $80M cash

Bento: A Steam Deck in a Keyboard

3D printable 6" f/5 compact travel telescope model

The Zed Debugger Is Here

Show HN: I made an app that lets you save audio to your Cameral Roll

The unreasonable effectiveness of fuzzing for porting programs

TI to invest $60B to manufacture foundational semiconductors in the U.S.

Microsoft wants you to buy a new computer. Make your current one secure again?

CPU-Based Layout Design for Picker-to-Parts Pallet Warehouses

Websites are tracking you via browser fingerprinting

SpaceX Starship 36 Anomaly