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 ---

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 > 🌐 English | 中文文档

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 ` After that, reload plugins: ` /reload-plugins ` 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> On Windows, Node.js LTS is the supported runtime for Claude HUD setup. If setup says no JavaScript runtime was found, install Node.js for your shell first: `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. ---

Claude HUD gives you better insights into what's happening in your Claude Code session. | What You See | Why It Matters | |--------------|----------------| | Project path | Know which project you're in (configurable 1-3 directory levels) | | Context health | Know exactly how full your context window is before it's too late | | Tool activity | Watch Claude read, edit, and search files as it happens | | Agent tracking | See which subagents are running and what they're doing | | Todo progress | Track task completion in real-time |