jarrodwatts/claude-hud

What it solves

Claude HUD is a plugin for Claude Code that provides a real-time, always-visible status line (HUD) below the user's input. It solves the problem of lacking visibility into the internal state of a Claude Code session, such as context window usage, active tools, and agent progress, without requiring the user to manually query the system.

How it works

The plugin utilizes Claude Code's native statusline API. It processes JSON data from stdin and transcript JSONL files to extract information about tokens, tool activity, and agent status. It then renders this information as a formatted status line in the terminal, re-rendering after each interaction with a 300ms debounce to ensure smooth performance.

Who it’s for

Developers using Claude Code who want a constant, glanceable overview of their session's resource usage, project context, and the AI's current activity.

Highlights

• Real-time Monitoring: Tracks context health (with a visual bar), usage rate limits, and session duration.
• Tool and Agent Tracking: Displays active tools (read, edit, search) and the status of running subagents.
• Project Context: Shows the current project path and Git branch status (including dirty state).
• Highly Customizable: Offers presets (Full, Essential, Minimal) and a deep configuration system for layout, colors, and language (English, Simplified Chinese, Traditional Chinese).
• Native Integration: Works in any terminal without needing separate windows or tmux.