Skip to main content
Claude HUD GuideClaude HUD Guide
Install Claude HUD

Three commands to put Claude HUD directly under your prompt.

This install flow mirrors the upstream plugin README but packages the command order, platform notes, and restart step into one page you can keep open while configuring Claude Code.

Open GitHubRead the FAQ

Command Order

Run in Claude Code, then restart the app.

Upstream-safe flow

  1. Step 1

    Add the marketplace source

    Run this inside Claude Code so the plugin becomes installable.

    /plugin marketplace add jarrodwatts/claude-hud

  2. Step 2

    Install the plugin

    Linux users should set TMPDIR first if `/tmp` is on a separate filesystem.

    /plugin install claude-hud

  3. Step 3

    Configure the statusline

    Restart Claude Code after setup writes the new statusLine config.

    /claude-hud:setup

Linux note

Use a writable TMPDIR before installing.

If `/tmp` is mounted on a different filesystem, Claude HUD installation can fail with `EXDEV: cross-device link not permitted`.

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

Windows note

Install Node.js LTS if setup cannot find a JavaScript runtime.

The upstream README recommends Node.js LTS as the simplest fallback when `/claude-hud:setup` reports no runtime on Windows.

winget install OpenJS.NodeJS.LTS

Independent-site disclaimer

Claude HUD is an upstream open-source plugin maintained in its own GitHub repository. This site is an independent guide built to explain the install flow and key capabilities more clearly. For releases, issues, and source code, always defer to the upstream repository.