Claude HUD

Claude HUD uses Claude Code's native statusline API — no separate window, no tmux required, works in any terminal. ` Claude Code → stdin JSON → claude-hud → stdout → displayed in your terminal ↘ transcript JSONL (tools, agents, todos) ` Key features: • Native token data from Claude Code (not estimated) • Scales with Claude Code's reported context window size, including newer 1M-context sessions • Parses the transcript for tool/agent activity • Updates every ~300ms ---

Usage display is enabled by default when Claude Code provides subscriber rate_limits data on stdin. It shows your rate limit consumption on line 2 alongside the context bar. Free/weekly-only accounts render the weekly window by itself instead of showing a ghost 5h: -- placeholder. The 7-day percentage appears when above the display.sevenDayThreshold (default 80%): ` Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) | ██████████ 85% (2d / 7d) ` To disable, set display.showUsage to false. Requirements: • Claude subscription usage data from Claude Code stdin • Not available for API-key-only users Troubleshooting: If usage doesn't appear: • Ensure you're logged in with a Claude subscriber account (not API key) • Check display.showUsage is not set to false in config • API users see no usage display (they have pay-per-token, not rate limits) • AWS Bedrock models display Bedrock and hide usage limits (usage is managed in AWS) • Claude Code may leave rate_limits empty until after the first model response in a session • Older Claude Code versions that do not emit rate_limits will not show subscriber usage

A Claude Code plugin that shows what's happening — context usage, active tools, running agents, and todo progress. Always visible below your input.   !Claude HUD in action

Inside a Claude Code instance, run the following commands: Step 1: Add the marketplace ` /plugin marketplace add jarrodwatts/claude-hud ` Step 2: Install the plugin <details> <summary><strong>⚠️ Linux users: Click here first</strong></summary> On Linux, /tmp is often a separate filesystem (tmpfs), which causes plugin installation to fail with: ` EXDEV: cross-device link not permitted ` Fix: Set TMPDIR before installing: `bash mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude ` Then run the install command below in that session. This is a Claude Code platform limitation. </details> ` /plugin install claude-hud ` Step 3: Configure the statusline ` /claude-hud:setup ` <details> <summary><strong>⚠️ Windows users: Click here if setup says no JavaScript runtime was found</strong></summary> If setup says no JavaScript runtime was found on Windows, install one for your shell first. The simplest fallback is Node.js LTS: `powershell winget install OpenJS.NodeJS.LTS ` Then restart your shell and run /claude-hud:setup again. </details> Done! Restart Claude Code to load the new statusLine config, then the HUD will appear. On Windows, make that a full Claude Code restart after setup writes the new statusLine config. ---