Claude HUD
ActiveDescription
A Claude Code plugin that shows what's happening — context usage, active tools, running agents, and todo progress for enhanced agent workflow visibility.
Key Features
- Context window health — Real-time context usage percentage with green→yellow→red gradient to prevent overflow
- Tool activity monitoring — Live display of Claude's read/edit/grep operations with file names
- Agent tracking — Shows running sub-agents with model name, duration, and status
- Todo progress tracking — Real-time task list completion progress (e.g., 2/5)
- Native statusline API — Built on Claude Code's native statusline interface, no tmux or extra terminal needed
- Configurable presets — Full/Essential/Minimal presets with language switching and custom color thresholds
Use Cases
💡 Monitor context usage during long Claude Code sessions to avoid unexpected truncation
💡 Observe tool call sequences and sub-agent status in real-time when debugging agent behavior
💡 Track multi-task todo completion progress in team collaboration workflows
💡 Customize HUD appearance to match different terminal color schemes and language preferences
💡 Teaching scenarios demonstrating Claude Code's internal workflow to students
Strengths & Limitations
✅ Strengths
- • Actively maintained, recent updates
- • High community interest (27.8k stars)
- • Permissive open-source license (MIT)
- • Responsive to issues, low backlog
Categories
Quick Start
```
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup
```