Claude Code mod

usage-meter

Sleek colored 5-hour and weekly usage bars in the footer; warns at 75%/90% and before agent waves when the window is low.

Install

From source
git clone https://github.com/eshin087/claude-code-mods.git
claude --plugin-dir ./claude-code-mods/usage-meter

The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.

What it can access

Reach
L1Reads: reads mod state, persists state, draws
Sees
Agent|Workflow calls
Draws in
SessionMode
Hooks
session.startsession.measureui.rendertool.call

From a static scan of the mod's code by awesome-claude-code-mods. It shows what the code asks for, not a security review.

How Claude Code mods work

  • A mod is a plugin with a JavaScript or TypeScript module that runs inside Claude Code (version 2.1.287 or later). It can draw panes beside the transcript, a band above the prompt, buttons and toasts, restyle the spinner and tool rows, and watch or rewrite tool calls and prompts.
  • It installs like any plugin: add its marketplace with /plugin marketplace add owner/repo, then /plugin install name@marketplace.
  • Check what a mod can reach before installing: it runs with your permissions. Reach goes from drawing only, to reading files, to writing files or running processes, to the network. Run claude plugin validate on a clone to list its hooks and calls without running it.
  • Turn one off from the Installed tab in /plugin, or start Claude Code with --safe-mode to skip every customization for a session.
Claude Code docs

Details

Folder
usage-meter
Author
eshin087
Last updated
25 October 2026

FAQ

What is usage-meter?

Sleek colored 5-hour and weekly usage bars in the footer; warns at 75%/90% and before agent waves when the window is low. It is a mod for Claude Code, from eshin087/claude-code-mods on GitHub.

What can the usage-meter mod access?

Its widest reach is "reads" (reads mod state, persists state, draws). It sees Agent|Workflow calls. It draws in SessionMode. Like any mod, it runs with your permissions.

How do I install usage-meter?

Clone eshin087/claude-code-mods and start Claude Code with --plugin-dir pointing at the mod's folder (usage-meter).

More context & usage mods

Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.