Labs · Claude Code plugin
TopX HUD
A free Claude Code plugin that shows context use, the 5-hour and 7-day limits and whether a turn is running above the prompt, with a Compact button and a /topx pane of recent turns.
What it shows
- Context use as a small liquid globe: blue, amber from 75%, red from 90%.
- A Compact button that runs the same compaction as /compact.
- The 5-hour and 7-day limits, with the time left until the 5-hour reset.
- /topx opens a pane of recent turns: duration, errors and tools used.
- Follows the light or dark appearance of the desktop app; a terminal gets one line of text.
- Speaks English or Chinese: it follows Claude Code's language setting or your locale, and TOPX_HUD_LANG picks one outright.
Install
Version 0.2.1. Needs Claude Code 2.1.286 or newer. Free to download, no account needed; MIT licence.
- Download topx-hud.zip, then run
mkdir -p ~/.claude/mods && unzip topx-hud.zip -d ~/.claude/mods. - Add
"env": { "CLAUDE_CODE_PLUGIN_DIRS": "~/.claude/mods/topx-hud" }to ~/.claude/settings.json, preserving any existing settings. - Open a new session. The strip appears above the prompt in every session.
To try it in one session only, run claude --plugin-dir ~/.claude/mods/topx-hud.
Claude Code plugins built on function hooks are an early-access feature and may change between releases. To remove the plugin, delete its setting and the topx-hud folder.