GaoSSR/best-claude-hud

Minimal Claude Code statusline HUD powered by Rust.

What it solves

best-claude-hud is a high-performance statusline tool that provides a visual HUD (Heads-Up Display) for Claude Code in the terminal. It replaces the default status line with a detailed, customizable view of essential information, such as the active model, reasoning effort, Git status, and context window usage, which would otherwise be less visible or harder to track during a session.

How it works

The tool is written in Rust for performance and integrates with Claude Code via the statusLine configuration setting. Claude Code sends real-time status data (model, workspace, context window, etc.) to the tool via stdin, which the tool then processes and renders as a formatted status line in the terminal using ANSI colors and optional Nerd Font glyphs.

Who it’s for

Developers using Claude Code in their terminal who want a more informative and visually organized status line to monitor their AI interactions, project state, and resource usage.

Highlights

  • Comprehensive Monitoring: Displays model name, live reasoning effort (e.g., low, medium, high, max), and context window usage (tokens and percentage).
  • Project Context: Shows the launch directory and Git branch status, including clean/dirty states and ahead/behind counts.
  • Customizable Appearance: Includes a TUI configuration interface and multiple built-in themes (e.g., Gruvbox, Nord, Tokyo Night) with support for custom themes.
  • Performance: Built with Rust to ensure minimal overhead and high responsiveness.
  • Prompt Noise Reduction: Includes a utility to patch Claude Code's cli.js to reduce context warning noise.

Related

  • Project
    jarrodwatts/claude-hud

    A Claude Code plugin that adds a real-time status line to the terminal, providing visibility into context usage, tool activity, and agent progress.

  • Project
    Owloops/claude-powerline

    A customizable vim-style statusline for Claude Code that provides real-time tracking of token usage, costs, git status, and context window utilization.

  • Project
    leeguooooo/claude-code-usage-bar

    A real-time status bar for Claude Code and the Claude macOS app that displays rate limits, context window usage, and prompt-cache freshness.

  • Project
    stephenleo/cship

    A customizable, Rust-based statusline for Claude Code that displays real-time session cost, context window usage, and API limits.

  • Project
    sirmalloc/ccstatusline

    ccstatusline is a Node.js‑based, highly customizable status‑line formatter for the Claude Code CLI. It displays model info, token usage, git/CI details, sandbox state, and other metrics directly in the terminal, with rich visual options (Powerline, gradients, custom glyphs) and a TUI editor for layout configuration.