usage-meter (HolyGrail)

Reviewed at commit 1572ebe New version, not yet reviewed

Shows context, 5-hour, weekly and per-model weekly limit usage above the prompt

Made by
HolyGrail
What we checked

Shows context use and your 5-hour, weekly and per-model weekly limit usage as bars above the prompt. Every five minutes it asks Anthropic's usage endpoint for the per-model figures using your own Claude login; limit readings are shared between your sessions through the mod's store. It reads no files and runs no programs.

Review details

Static review of the source at the pinned commit; not run. Registers session.start (reads $.session.usage, starts a 60 s timer), session.end, classic.SessionStart (clear, resume, fork, compact), session.measure and ui.render for the AbovePrompt band (text bars in the terminal, SVG bars in the desktop app). The only network call is $.http.fetch to https://api.anthropic.com/api/oauth/usage with auth from $.session.authorize(), passed as an opaque handle, at most once per five minutes across sessions; it is skipped when there is no first-party login, and the answer is parsed for weekly_scoped limits only. Readings are saved in $.store under reading:, scoped and scoped-tried, and stale ones are deleted after 8 days. Failures are swallowed. Reset times of the 5-hour window are shown in JST.

What it uses
  • Reads your prompts: no
  • Sees tool calls: no
  • Blocks or changes tool calls: no
  • Reads or writes files: no
  • Runs programs on your machine: no
  • Calls the model (uses tokens): no
  • Sends data over the network: yes
  • Stores data: yes
  • Shows something on screen: yes
Hooked events
Made this mod? Add a badge to your README

modsforClaude badge for usage-meter (HolyGrail)

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-holygrail.svg)](https://modsforclaude.com/mods/usage-meter-holygrail/)

← All mods