Claude Code mod

usage-meter

A machine-wide meter of the plan's rolling 5-hour usage: every session's turns summed as effective tokens, the cap learned from each session-limit hit, the burn on the status line, a toast before the wall, /usage and a usage_status tool so Claude can pace itself. No process runs, no model calls.

2 starsContext & usage modsValidates on Claude Code 2.1.316 Source

Install

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

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

What it can access

Reach
L2Writes or runs: writes files, drives Claude, reads files, reads env vars, reads mod state, draws
Sees
classic hooks, mcp__usage-meter__usage_status calls
Hooks
session.startturn.completesession.appendclassic.StopFailuretool.checktool.callcommand.runsession.end

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

Repository
joeldg/claude-mods
Folder
usage-meter
Author
joeldg
Type
Context & usage mods
Last updated
16 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-meter?

A machine-wide meter of the plan's rolling 5-hour usage: every session's turns summed as effective tokens, the cap learned from each session-limit hit, the burn on the status line, a toast before the wall, /usage and a usage_status tool so Claude can pace itself. No process runs, no model calls. It is a mod for Claude Code, from joeldg/claude-mods on GitHub.

What can the usage-meter mod access?

Its widest reach is "writes or runs" (writes files, drives Claude, reads files, reads env vars, reads mod state, draws). It sees classic hooks, mcp__usage-meter__usage_status calls. Like any mod, it runs with your permissions.

How do I install usage-meter?

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

Is usage-meter popular?

joeldg/claude-mods has 2 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 16 October 2026.

More context & usage mods

odometer

DJPalefaceSD/rostech-mods

An odometer above the prompt: how long this session has run and what it has cost.

Context & usage mods/plugin install

marquee

21

ersinkoc/claude-mods

KOZMOS Marquee: a status-line ticker. Model and effort, context fill, 5-hour and weekly limits with the reset countdown, session cost, git branch with ahead and dirty counts, and the tool running now, refreshed every second; it scrolls like a marquee when longer than its width. /marquee toggles it.

Context & usage mods/plugin install

chronicle

21

ersinkoc/claude-mods

KOZMOS Chronicle: the session as a timeline. Prompts, turn ends with duration, tool count and spend, subagents spawned and finished, commits and pushes, failed tools, compactions, and rate-limit and context milestones, each stamped HH:MM:SS, newest first, with filters. /chronicle toggles the sidebar.

Context & usage mods/plugin install

context-xray

12

VedantAndhale/claude-pro-kit

A pane with the exact breakdown of what fills Claude's context: system prompt, tools, memory files, skills, messages, and which tools load on every request.

Context & usage mods/plugin install

session-budget

5

partalemre/MODZ

A per-session spend budget (% of the 5h limit or $): notice at 80%, Continue anyway / Stop at 100% on a new prompt

Context & usage mods/plugin install

cost-bar

1

Justmalhar/awesome-claude-mods

A one-row band above the prompt with session cost, 5h/7d plan limits and an optional budget bar.

Context & usage mods/plugin install

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