---
url: "https://www.reddit.com/r/ClaudeAI/comments/1wxntoy/i_made_a_mod_that_shows_your_5hweekly_usage_live/"
title: I made a Mod that shows your 5h/weekly usage live, a reset forecast and context % above the prompt box, with optional auto compact and a manual compact button
source_kind: reddit
subreddit: ClaudeAI
author: Antpocalypse_7
captured: "2026-10-08T18:10:03+00:00"
comment_tree: false
topics: [agent-tooling, claude-code]
summary: A mod for Claude Code that displays live 5-hour/weekly usage, reset forecasts, context percentage, and optional auto-compact features.
status: ok
---

I used to keep checking my usage way too often. Settings, the usage page, /usage , or the little circle for the Context usage. I also kept forgetting to compact until the context was huge and my limits were draining faster. When I found out yesterday that Claude Mods have landed, I built a small helper that sits above the prompt and shows it all, along with a few more features I've wanted since I started using Claude Code in the Desktop App (also works in the terminal btw).
What it shows:
- 5 Hour and Weekly usage, matching the app's own Plan usage limits panel (it's your whole account, so chat and Cowork use counts too)
- A forecast of where you'll be at reset. It learns your usual pace, so an early context burst doesn't set off alarms. If you're on course to run out, it says roughly when and warns you.
- Context window % with a Messages, Tools and Other breakdown, as /context counts it
- A Compact button, plus optional Auto compact at a % you pick (30% by default, but anywhere between 15% to 99% works). It's set per session and off for new sessions, so a big feature build can keep its full context if you'd like or you can save tokens when you don't need big context and are okay with compacting often.
It loads on any existing Claude Code chat/session once you open them and can also be collapsed to one line which still shows the relevant usage info and timers, and /quota toggles it on and off. Works on both Dark and Light Themes, automatically switching when you switch the theme on the desktop app. It also works on all window widths down to the narrowest in the desktop app.
I t runs locally and reads what Claude Code already has (context data plus the usage data each reply carries). About every 2 minutes it calls the servers for /usage and /context via your existing login, the same data the usage panel shows to ensure up to date data on both, especially the context breakup data. That's the only network call. It never handles your credentials directly. It's MIT Licensed, mostly one file, so please read it before installing.
Known limits: it can't draw on the desktop's empty "Welcome back" screen until you send a message, because there's no session there yet. And it's v0.1.3, so expect rough edges.
Install from inside Claude Code:

```
/plugin install claude-code-usage-quota --marketplace anantraghunath/claude-code-usage-quota-mod 
```

Repo and screenshots: https://github.com/anantraghunath/claude-code-usage-quota-mod
Full disclosure: I built it with Claude Code in about a day. Feedback and bug reports are all welcome.
Credit where it's due: this started from the prompt u/itsxzy shared in I'm liking the new mods feature . I took it and kept building. Thanks!