jarrodwatts/claude-hud

What it solves

Claude HUD provides a persistent, real-time status display for Claude Code users, eliminating the need to manually check context usage, rate limits, and agent activity. It transforms the terminal interface by adding a visible HUD (Heads-Up Display) below the input line, keeping critical session metadata always in view.

How it works

It functions as a status line command for Claude Code. The plugin receives session data (such as model, context window, cost, and rate limits) via stdin and parses the session transcript to track active tools, running agents, and todo progress. It then prints a formatted status line directly into the terminal without requiring a separate window or tmux.

Who it’s for

Developers using Claude Code who want better visibility into their LLM resource consumption, project state (git branch, path), and the progress of autonomous agents during a session.

Highlights

• Resource Monitoring: Visual bars for context window usage and subscriber rate limits with color-coded warnings.
• Activity Tracking: Optional lines to monitor active tools, running agents, and todo list progress.
• Environment Context: Displays current model, provider (e.g., Bedrock, Vertex), project path, and git branch status.
• Deep Customization: Extensive configuration options for layout (compact vs. expanded), element order, colors, and language support (English, Simplified Chinese, Traditional Chinese).
• Cost Tracking: Ability to show session cost, daily cumulative spend, and weekly quotas.