Repolode
Submit
GaoSSR

GaoSSR/best-claude-hud

A minimal Rust-built statusline for Claude Code showing model, Git state, workspace, and context window usage in the terminal.

View on GitHub
Stars
1,074
Forks
34
Open issues
0
Last commit
2 months ago

What is it?

best-claude-hud is a statusline HUD for Claude Code, the terminal coding assistant. It sits at the bottom of the Claude Code interface and shows the active model with its reasoning effort level, the launch directory, the Git branch with clean, dirty, or conflict state and ahead/behind counts, and how much of the context window is in use.

The tool is written in Rust and installed via npm as prebuilt native binaries, so Rust is not required on the user's machine. A single command, `best-claude-hud --setup`, writes the required statusLine entry into ~/.claude/settings.json while preserving existing settings. Supported platforms include macOS (arm64 and x64), Linux x64 (musl), and Windows x64.

The HUD is configurable through a TUI, a config.toml file, and built-in or custom themes, including Nerd Font and Powerline styles. Optional segments cover usage and rate limits, cost, session, and output style. Model display names and context limits can be customized for third-party models.

Key features

  • 01Shows the current model with live reasoning effort level
  • 02Displays Git branch, clean/dirty/conflict state, and ahead/behind counts
  • 03Reports context window usage from Claude Code's statusLine data
  • 04Installs via npm with prebuilt binaries, no Rust toolchain needed
  • 05Offers built-in themes and a TUI for configuration

Use cases

  • Keeping track of context window usage during long Claude Code sessions
  • Checking Git branch and working tree state without leaving the terminal
  • Customizing the statusline display for multiple models, including third-party ones

Quick start

  1. 1

    Install and configure Claude Code in one line

    npm install -g best-claude-hud@latest && best-claude-hud --setup
  2. 2

    Restart Claude Code so it loads the new settings

Things to know

  • Requires Claude Code with statusLine support and Git for branch display.
  • Nerd Font or Powerline themes need a Nerd Font installed in your terminal.
  • Linux arm64 and Windows arm64 are not yet supported.

Topics

#claude-code#statusline#terminal#cli#git#rust#developer-tools#hud#linux#macos

FAQ

What is best-claude-hud?
A minimal Rust-built statusline for Claude Code showing model, Git state, workspace, and context window usage in the terminal. best-claude-hud is a statusline HUD for Claude Code, the terminal coding assistant. It sits at the bottom of the Claude Code interface and shows the active model with its reasoning effort level, the launch directory, the Git branch with clean, dirty, or conflict state and ahead/behind counts, and how much of the context window is in use.
Is best-claude-hud free to use? What license does it have?
best-claude-hud is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is best-claude-hud still maintained?
Updated within 6 months. The last commit to best-claude-hud was on Aug 13, 2026.
What can I use best-claude-hud for?
Keeping track of context window usage during long Claude Code sessions Checking Git branch and working tree state without leaving the terminal Customizing the statusline display for multiple models, including third-party ones
How do I install best-claude-hud?
Install and configure Claude Code in one line: npm install -g best-claude-hud@latest && best-claude-hud --setup Restart Claude Code so it loads the new settings
Where can I get best-claude-hud?
The source code and installation instructions are on GitHub: https://github.com/GaoSSR/best-claude-hud

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects