Claude Code mod
usage-hud
A pixel Clawd above your prompt whose mood follows your context, session and weekly usage
Install
git clone https://github.com/lucassimzq/claude-usage-mod.git
claude --plugin-dir ./claude-usage-mod/.The repo has no marketplace file, so load the plugin folder directly with --plugin-dir.
What it can access
- Reach
- L3Network: network, runs processes, reads files, reads env vars, reads mod state, persists state, draws
- Sees
- every tool call
- Draws in
PaneAbovePromptSpinner- Hooks
session.startturn.steptool.callturn.completesession.measurecommand.runui.render
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.
Details
- Repository
- lucassimzq/claude-usage-mod
- Folder
.- Author
- lucassimzq
- License
- MIT
- Last updated
- 18 October 2026
- Listed in
- awesome-claude-code-mods
FAQ
What is usage-hud?
A pixel Clawd above your prompt whose mood follows your context, session and weekly usage It is a mod for Claude Code, from lucassimzq/claude-usage-mod on GitHub.
What can the usage-hud mod access?
Its widest reach is "network" (network, runs processes, reads files, reads env vars, reads mod state, persists state, draws). It sees every tool call. It draws in Pane, AbovePrompt, Spinner. Like any mod, it runs with your permissions.
How do I install usage-hud?
Clone lucassimzq/claude-usage-mod and start Claude Code with --plugin-dir pointing at the mod's folder (.).
Is usage-hud popular?
lucassimzq/claude-usage-mod has 5 GitHub stars and 0 forks, and is included in 1 curated Claude Code list. It was last updated on 18 October 2026.
More context & usage mods
squad-chat
5chrisluo5311/squad-chat
The all-in-one Claude Code plugin. Talk with your squad, share code, and keep live rooms (usage, git, weather, lo-fi and more) next to your session. Zero tokens, zero leaks to Claude.
vitals
5naicud/cc-vitals
A light, framed live dashboard above the prompt, in the terminal and in the desktop app: model and effort, context and account-wide plan-limit meters (5-hour, weekly, per model, usage credits), cost and burn rate, tokens and cache per turn and session, auto-compaction, live tools, background shells and every subagent with its model and effort, plus weekly and monthly usage and the account's plan limits by product. Two columns on wide terminals, sized to the rows it has, never scrolling. Requires ccusage (npm i -g ccusage) for the usage section. /vitals-low, /vitals-medium and /vitals-high set the detail level; /vitals pane full view, /vitals report usage report.
opm
5harshadmadaye/OPM
An opinionated engineering workflow for Claude Code: brainstorm -> plan -> TDD execution with fresh-context subagents -> verification -> captured learnings. Lean reviewers, stack-specific patterns for TypeScript/React, Python and Flutter, and six light safety hooks.
wavy-usage
5BatuhanCakmakk/wavy-usage
Liquid-filled rings above the Claude Code prompt for the 5-hour and 7-day limit windows, context fill and prompt-cache lifetime, a fighter jet that shows the model's effort, and a pane of recent turns, their cost, their share of the 5-hour window and what filled it.
nextcost
5HMarzban/claude-mod
See what your next message costs: a live band above the prompt with the prompt-cache countdown, the re-warm price, session cost, context and your 5h/7d limits.
agent-graph
4CalvoSeko/claude-factory-mod
Define agents with skills and context on a drag-and-drop graph, connect them, and run them locally or as Claude Managed Agents.
Browse the most popular Claude Code mods, all context & usage mods, or the skills and MCP server directories.