Claude Code mod

usage-bar

A small coloured bar in the desktop prompt footer showing how much of your 5-hour session limit is used

Context & usage mods Plugin marketplaceValidates on Claude Code 2.1.316 Source

Install

Inside Claude Code
/plugin marketplace add nigelramsay/nigels-plugins
/plugin install usage-bar@nigelramsay

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

What it can access

Reach
L1Reads: reads mod state, persists state, draws
Draws in
SessionMode
Hooks
session.startsession.measureui.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

Folder
plugins/usage-bar
Marketplace
nigelramsay
Author
Nigel Ramsay
Last updated
6 October 2026

FAQ

What is usage-bar?

A small coloured bar in the desktop prompt footer showing how much of your 5-hour session limit is used It is a mod for Claude Code, from nigelramsay/nigels-plugins on GitHub.

What can the usage-bar mod access?

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

How do I install usage-bar?

Inside Claude Code (v2.1.287 or later), run /plugin marketplace add nigelramsay/nigels-plugins and then /plugin install usage-bar@nigelramsay.

More context & usage mods

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