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.

Made by
Hamza Zafar
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
Screenshot of usage-meter
Made this mod? Add a badge to your README

modsforClaude badge for usage-meter

Paste this into your README. The badge says reviewed once the current version has been reviewed, and links readers to this page.

[![Listed on modsforClaude](https://modsforclaude.com/badge/usage-meter.svg)](https://modsforclaude.com/mods/usage-meter/)

← All mods