Claude Code mod

usage-meter

Five-hour and weekly plan usage as one line under the prompt, with reset countdown and pace forecast

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add ianwilson97/claude-mods
/plugin install usage-meter@ianwilson-mods

Mods install like plugins. Run /reload-plugins or start a new session to load it.

What it can access

Reach
L1Reads: reads mod state, draws
Hooks
session.startsession.measurecommand.run

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
Marketplace
ianwilson-mods
Author
Ian Wilson
Last updated
19 October 2026

FAQ

What is usage-meter?

Five-hour and weekly plan usage as one line under the prompt, with reset countdown and pace forecast It is a mod for Claude Code, from ianwilson97/claude-mods on GitHub.

What can the usage-meter mod access?

Its widest reach is "reads" (reads mod state, draws). Like any mod, it runs with your permissions.

How do I install usage-meter?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add ianwilson97/claude-mods and then /plugin install usage-meter@ianwilson-mods.

More context & usage mods

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