usage-meter
Reviewed
at commit e839261
New version, not yet reviewed
Your plan's 5-hour and 7-day usage as small bars above the prompt, with the reset countdown and the session's cost.
0 upvotes
Log in to upvote or save- Made by
- Hamza Zafar
- Pinned commit
-
e8392612e80094e5e048907751555257da0eb790 - What we checked
-
Shows your plan's 5-hour and 7-day usage as small bars above the prompt, with the reset countdown and the session cost, and pops up a toast once a window passes 90%. It reads Claude Code's own usage figures and, once per session, a small band-order file in your Claude config folder to decide where its bar sits among other band mods. It makes no network calls, runs no programs and writes nothing.
Review details
Static review of the source at the pinned commit; not run. Delta review of the changes since c17bdb9; the rest carries over from the review at that commit. Registers session.start (starts a 60 second redraw timer, reads $.session.usage), session.measure (takes rate limit and cost figures) and ui.render for AbovePrompt. Calls $.toast once per window per reset period at 90% or more. State is held in host atoms (snapshot, tick, warned); no $.store, network or process use. What changed: a new hooks/bands.ts lets several band mods stack above the prompt in a user-chosen order. Once per session register.tsx reads CLAUDE_CONFIG_DIR and HOME with $.env.get, checks with $.fs.exists and reads <configDir or ~/.claude>/claude-code-mods/bands.json with $.fs.read, parses it as JSON {order: string[]} (anything else gives an empty order) and sorts its own Box among other mods' bands; a read error is swallowed. The file is only read, never written, and its content only affects the on-screen order. The render now returns a keyed column Box instead of a plain Box, and unpacks another band mod's column if present. Failures are swallowed so the session is unaffected.
- What it uses
-
- Reads your prompts: no
- Sees tool calls: no
- Blocks or changes tool calls: no
- Reads or writes files: yes
- Runs programs on your machine: no
- Calls the model (uses tokens): no
- Sends data over the network: no
- Stores data: no
- Shows something on screen: yes
- Hooked events
Made this mod? Add a badge to your README
Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.
[](https://modsforclaude.com/mods/usage-meter/)