**claude-hud**

Claude HUD

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

[](LICENSE) [](https://github.com/jarrodwatts/claude-hud/stargazers)

Install

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

⚠️ Linux users: Click here first

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:

mkdir -p ~/.cache/tmp && TMPDIR=~/.cache/tmp claude

Then run the install command below in that session. This is a [Claude Code platform limitation](https://github.com/anthropics/claude-code/issues/14799).

/plugin install claude-hud

After that, reload plugins:

/reload-plugins

**Step 3: Configure the statusline**

/claude-hud:setup

⚠️ Windows users: Click here if setup says no JavaScript runtime was found

On Windows, Node.js LTS is the recommended runtime for Claude HUD. If setup says no JavaScript runtime was found, install Node.js for your shell first:

winget install OpenJS.NodeJS.LTS

Then restart your shell and run `/claude-hud:setup` again.

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.

---

What is Claude HUD?

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

...