Claude HUD Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection. Claude HUD is a Claude Code plugin that adds a persistent statusline to your terminal showing real time context window usage, active tool calls, running subagents, and todo progress — always visible below your input prompt. What It Does Feature Description Context health Visual bar showing how full your context window is (green → yellow → red) Tool activity Live display of file reads, edits, and searches as they happen Agent tracking Shows which subagents are running and what they're doing Todo progress Real time task completion tracking Usage limits Claude subscriber rate limit consumption Git status Current branch, dirty state, ahead/behind remote Requirements Claude Code v1.0.80+ Node.js 18+ or Bun Installation Run these commands inside a Claude Code session: Step 1: Add the marketplace Step 2: Install the plugin Linux users : If you get EXDEV: cross device link not permitted , set TMPDIR first: Step 3: Configure the statusline Windows users : If setup reports no JavaScript runtime, install Node.js LTS first: Step 4: Restart Claude Code to load the new statusLine config. What You See Default 2 line layout With optional lines enabled Configuration Interactive configuration (recommended) This opens a guided flow with preset options: Preset Shows Full Everything — tools, agents, todos, git, usage, duration Essential Activity lines + git, minimal clutter Minimal Model name and context bar only Manual configuration Edit ~/.claude/plugins/claude hud/config.json directly: Key Configuration Options Layout Path level examples: 1 → [Opus] │ my project git:(main) 2 → [Opus] │ apps/my project git:(main) 3 → [Opus] │ dev/apps/my project git:(main) Context display formats Element ordering (expanded layout) Omit any entry from the array to hide it entirely. Git status options Colors Supported values: named colors ( dim , red , green , yellow , magenta , cyan , brightBlue , brightMagenta ), 256 color numbers ( 0 255 ), or hex ( rrggbb ). How It Works Claude HUD uses Claude Code's native statusline API — no separate window, no tmux needed: Token data comes directly from Claude Code (not estimated) Scales with reported context window size including 1M context sessions Parses transcript for tool/agent activity Updates every ~300ms Common Patterns Minimal setup for focused work Full monitoring setup Always show 7 day usage Output: Context █████░░░░░ 45% │ Usage ██░░░░░░░░ 25% (1h 30m / 5h) ██████████ 85% (2d / 7d) Troubleshooting HUD not appearing after setup Fully restart Claude Code (quit and re run claude in terminal) On macOS, ensure you've fully quit the app, not just closed the window Config not applying Check for JSON syntax errors — invalid JSON silently falls back to defaults Validate: cat ~/.claude/plugins/claude hud/config.json node e "JSON.parse(require('fs').readFileSync('/dev/stdin','utf8'))" Delete config and run /claude hud:configure to regenerate Git status missing Verify you're in a git repository ( git status ) Ensure gitStatus.enabled is not false in config Tool/agent/todo lines not showing These are hidden by default — enable with showTools , showAgents , showTodos Lines only render when there's active activity to display Usage limits not showing Requires a Claude subscriber account (not API key only) AWS Bedrock users see Bedrock label; usage is managed in AWS console instead Usage data may be empty until after the first model response in a new session Older Claude Code versions that don't emit rate limits won't show subscriber usage Linux cross device error on install Windows: no JavaScript runtime found Plugin Commands Reference Command Description /plugin marketplace add jarrodwatts/claude hud Register the plugin source /plugin install claude hud Install the plugin /claude hud:setup Initial setup wizard, writes statusLine config /claude hud:configure Interactive configuration with preview Config File Location

claude-hud-statusline