Claude Code mod

usage-dashboard

Live session dashboard: tokens, cost, context, limits, agents, tasks, background jobs, tools and an animated pet

Context & usage modsValidates on Claude Code 2.1.316 Source

Install

From source
git clone https://github.com/pieroprUnap/usage-dashboard.git
claude --plugin-dir ./usage-dashboard/.

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

What it can access

Reach
L1Reads: reads env vars, reads settings, reads mod state, draws
Sees
classic hooks, every prompt, every tool call
Draws in
Pane
Hooks
session.startcommand.runclassic.UserPromptSubmitprompt.submitclassic.PostToolUseclassic.Stopclassic.SessionStartturn.stepturn.starttool.callsession.sendsession.receiveturn.completeui.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.
Claude Code docs

Details

Repository
pieroprUnap/usage-dashboard
Folder
.
Type
Context & usage mods
License
MIT
Last updated
8 October 2026
Listed in
awesome-claude-code-mods

FAQ

What is usage-dashboard?

Live session dashboard: tokens, cost, context, limits, agents, tasks, background jobs, tools and an animated pet It is a mod for Claude Code, from pieroprUnap/usage-dashboard on GitHub.

What can the usage-dashboard mod access?

Its widest reach is "reads" (reads env vars, reads settings, reads mod state, draws). It sees classic hooks, every prompt, every tool call. It draws in Pane. Like any mod, it runs with your permissions.

How do I install usage-dashboard?

Clone pieroprUnap/usage-dashboard and start Claude Code with --plugin-dir pointing at the mod's folder (.).

More context & usage mods

usage-both

paulpc2/claude-code-mods

Always show both the 5-hour and weekly Claude usage, with colored progress bars, above the prompt

Context & usage mods/plugin install

usage-deck

codeclawd/usage-deck

Plan limits, context fill and prompt-cache warmth in one compact animated deck above the prompt

Context & usage mods/plugin install

usage-bars

karolis-z/claude-usage-bars

Progress bars above the prompt: context, 5-hour session and Fable weekly limit, with your own thresholds, alerts and a details pane.

Context & usage mods/plugin install

usage-dollars

hyvanmielenpelit/ClaudeCodeMods

Shows subscription usage for the 5-hour window and the week as API-equivalent dollars: estimated allowance first, then used and left, with 90% ranges; spending reports by date range

Context & usage mods/plugin install

usage-bars

jpzrdev/claude-mods

Shows session (5h) and weekly usage as 0-100% bars, with the time left until each window resets.

Context & usage mods/plugin install

usage-footer

BuzzScud/my-Claude-mods

One row in the footer: the context and your usage limits (5-hour, week, a model's own week) as bar tiles that fill as they are used, coloured by how full they are, each with its reset time, all four kept down to a 120-column window. /limits on | off.

Context & usage mods

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