Claude HUD

Active
GitHub JavaScript MIT

Description

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

Tags

agent tools coding claude workflow

Categories

🔄 Workflow

Quick Start

```
/plugin marketplace add jarrodwatts/claude-hud
/plugin install claude-hud
/reload-plugins
/claude-hud:setup
```
Visit GitHub

Related Projects