Claude Code's statusline gets a Rust rewrite and a brain icon

What it does

best-claude-hud is a Rust binary that Claude Code calls as an external statusLine command. It ingests the editor’s stdin payload and renders a compact terminal HUD showing the active model, reasoning effort level, stable workspace directory, git branch and dirty-state indicators, plus live context-window consumption. The whole thing ships through npm as prebuilt native binaries, so you do not need a Rust toolchain.

The interesting bit

The HUD cross-checks Claude Code’s internal /effort events to distinguish ordinary xhigh reasoning from the vendor-specific “Ultracode” mode, and it runs git commands with --no-optional-locks so the statusline never holds up your repository. That is a level of pedantry you usually do not get from a cosmetic shell script.

Key highlights

• Displays model name with a live reasoning-effort indicator (low through max/ultracode), rendered in bright purple with a brain icon.
• Shows git branch, ahead/behind counts, and clean/dirty/conflict state without creating .git/index.lock contention.
• Falls back to scanning the active transcript for context-window usage only when Claude Code’s official payload is missing or zeroed out.
• Ships via npm with platform-specific prebuilt binaries for macOS, Linux, and Windows; a Nix flake is also provided.
• Includes a TUI configurator, custom theme support, and a patch utility to quiet Claude Code’s context-warning noise.

Caveats

• Linux arm64 and Windows arm64 builds are listed as planned but not yet available.
• Some themes require a Nerd Font, and the tool only works with Claude Code versions that expose the statusLine extension point.

Verdict

Worth a look if you spend hours in Claude Code and want your terminal status bar to actually reflect reality. Skip it if you are content with the editor’s built-in minimal statusline or if you are on an unsupported architecture.