best-claude-hud

English | 简体中文 | 日本語

Minimal Claude Code statusline HUD, powered by Rust

best-claude-hud Overview

best-claude-hud is a high-performance Claude Code statusline tool written in Rust. It shows the status information you actually need while using Claude Code in a terminal: model and live reasoning effort, workspace, Git branch/status, context window usage, and optional usage/rate-limit metadata.

The default statusline focuses on:

- Claude model display with live reasoning effort when available
- Claude Code launch directory, stable across temporary working-directory changes
- Git branch, clean/dirty/conflict state, and ahead/behind counts
- context window usage from Claude Code's official statusLine data, with active-transcript fallback
- optional usage/rate-limit, cost, session, and output style segments

Install

best-claude-hud is distributed through npm. The npm package uses prebuilt native binaries; users do not need Rust installed.

Install best-claude-hud and configure Claude Code in one line:

Restart Claude Code after setup. Existing sessions do not automatically reload ~/.claude/settings.json.

Install only:

Using yarn or pnpm:

For users in China:

Update an existing installation:

Uninstall:

Nix

best-claude-hud also ships a Nix flake for declarative and reproducible environments.

Run without installing globally:

Install into a Nix profile:

For home-manager or another declarative setup, point Claude Code directly at the Nix store binary. The example below declaratively manages the entire ~/.claude/settings.json file and does not merge existing settings. Use it only for a new file or when all Claude Code settings are declared in the same Nix configuration:

If you keep ~/.claude/settings.json manually, run best-claude-hud --setup or add the statusLine…