Name: usage-hud
Author: ronanworks

What is usage-hud?

usage-hud is a Claude Code mod by ronanworks that 输入框下方是三列对齐的模型/用量/状态面板，上方是一只会按工具做动作、带着子代理小螃蟹来回走的像素螃蟹（终端；Windows / macOS / Linux）；配速预警和螃蟹情绪、每轮收据、一键压缩、额度恢复提醒、子代理看板 (/hud agents)、点档位切换. It is listed under Cost & usage and has 7 GitHub stars.

Type	Claude code mod
Author	ronanworks
Repository	ronanworks/claude-code-mods
Popularity	7 GitHub stars
Category	Cost & usage
Security	Review before installing (64/100)
Rank	#602 of 5,272 Claude Code mods; #112 in Cost & usage
License	MIT
Last commit	2026-10-08
Hooks	16 events
Sees	classic hooks, compaction, every prompt, every tool call
Draws on	TurnDuration, Pane, AbovePrompt, PromptHint

Is usage-hud safe to install?

usage-hud scores 64/100 on the MCPMods security check: Review before installing. Things to review: starts processes outside the sandbox; reads environment variables; watches every prompt or event. It passed 5 of 8 checks.

Mod footprints come from claude plugin validate, which lists every event a mod hooks and every API call it makes without running it.

Check	Result
No network access	Pass
Starts processes outside the sandbox	Review
Writes no files or config	Pass
Reads environment variables	Review
Watches every prompt or event	Review
Doesn't drive Claude	Pass
Passes claude plugin validate	Pass
Has an open-source license	Pass

API calls in its code

Call	What it means
`$.agent.list`
`$.clock.after`
`$.clock.every`
`$.clock.now`
`$.command.register`
`$.command.run`	drives Claude
`$.env.get`	reads env vars
`$.fs.exists`	reads files
`$.fs.read`	reads files
`$.process.run`	runs processes
`$.session.cwd`
`$.session.id`
`$.session.model`
`$.session.root`
`$.session.usage`
`$.settings.read`	reads settings
`$.store.get`	keeps its own state
`$.store.set`	keeps its own state
`$.ui.invalidate`	draws interface
`$.ui.log`	draws interface
`$.ui.open`	draws interface
`$.ui.resolve`	draws interface
`$.ui.toast`	draws interface

How do I install usage-hud?

Check your Claude Code version. Mods need Claude Code 2.1.287 or later and are on by default.
```
claude --version
```

Read its footprint. This lists every event it hooks and every API call it makes, without running it.

git clone https://github.com/ronanworks/claude-code-mods
claude plugin validate ./claude-code-mods/usage-hud

Install it. Run this in your terminal, then /reload-plugins in an open session.

claude plugin marketplace add ronanworks/claude-code-mods && claude plugin install usage-hud@claude-code-mods

Or ask Claude to set it up

Paste this into Claude Code and it installs usage-hud for you:

Install the "usage-hud" Claude Code mod from https://github.com/ronanworks/claude-code-mods/tree/main/usage-hud. Run claude plugin validate on it first and show me what it can access before you enable it.

What is usage-hud?

Is usage-hud safe to install?

API calls in its code

How do I install usage-hud?

Or ask Claude to set it up

More from ronanworks/claude-code-mods