claude-hud

Overview

Claude HUD is a real-time statusline plugin for Claude Code that displays session information at a glance — context usage, active tools, subagent tracking, and todo progress. It provides a persistent heads-up display so you always know what Claude Code is doing and how much context remains.

Key Features

• Context usage monitoring — Shows model name and a color-coded context usage bar so you can see how much of the context window has been consumed
• Live tool activity — Displays currently running tools with spinners and completed tools with execution counts
• Subagent tracking — Shows active subagents with their descriptions and runtime, so you can monitor parallel work
• Todo progress — Displays the current task and completion metrics for ongoing work

Who is this for?

Claude HUD is for Claude Code users who want visibility into their session state without interrupting their workflow. It is especially useful during long or complex sessions where tracking context consumption, tool activity, and subagent progress helps avoid surprises like context window exhaustion.