</>MCP Agents Market
Agent

claude-hud

by jarrodwatts27.4kJavaScriptUpdated 2026-08-15

A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress

Claude Code

claude-hud is a monitoring plugin for Claude Code that displays real-time session insights directly below your input prompt. It surfaces context window utilization, active tool operations, running sub-agents, and task completion progress in a persistent heads-up display. The AI sub-agent integrates natively with Claude Code's statusline API, requiring no separate terminal multiplexer, and updates automatically after each interaction with configurable layouts and multi-language label support.

Key Features

Real-time context window visualization with color-coded progress bars showing token usage against model limits, including support for extended 1M-context sessions
Live tool activity tracking that displays file reads, edits, grep operations, and MCP server invocations as they occur
Sub-agent monitoring showing which agents are active, their assigned tasks, and elapsed runtime
Task progress tracker displaying completed and remaining todo items from your session
Native statusline integration with no external dependencies—works in any terminal without tmux or separate windows
Configurable multi-line or compact single-line layouts with preset templates (Full, Essential, Minimal)
Support for English, Simplified Chinese, and Traditional Chinese interface labels with guided configuration flows
Git and Jujutsu version control status integration showing branch, uncommitted changes, ahead/behind counts, and file statistics

Use Cases

  • 01Monitor context window consumption during complex coding sessions to avoid hitting token limits mid-task
  • 02Track which files and tools Claude Code is actively reading or modifying to understand agent reasoning flows
  • 03Observe sub-agent delegation patterns and execution times when breaking down large development tasks
  • 04Keep task completion progress visible during multi-step project work without switching views
  • 05Identify when to manually compact context by watching real-time token usage approach warning thresholds
  • 06Verify git branch and working directory state inline while collaborating with Claude Code on version-controlled projects

Related Agents

View more

claude-hud — FAQ

What is claude-hud?+

claude-hud is a Claude Code plugin that provides a persistent heads-up display showing session metrics like context usage, active tools, running agents, and todo progress. It renders directly in your terminal below the input area using Claude Code's native statusline API.

How do I install claude-hud in Claude Code?+

Inside a Claude Code session, run `/plugin marketplace add jarrodwatts/claude-hud`, then `/plugin install claude-hud`, and finally `/claude-hud:setup` to configure the statusline. After setup completes, reload plugins with `/reload-plugins` and the HUD will appear after your next message.

Does claude-hud require an API key or external service?+

No, claude-hud operates entirely within Claude Code using data from stdin and the session transcript. It does not require any external API keys, accounts, or third-party services.

Which AI clients work with claude-hud?+

claude-hud is built exclusively for Claude Code as a native plugin. It does not support Claude Desktop, Cursor, Windsurf, or other AI coding assistants.

Is claude-hud free to use?+

Yes, claude-hud is open-source software released under the MIT License and free to use with any Claude Code installation.

Can I customize what information claude-hud displays?+

Yes, run `/claude-hud:configure` for a guided configuration flow to choose preset layouts (Full, Essential, Minimal), toggle individual elements like tools and agents, adjust label language, and customize git display options. Advanced users can edit the config.json file directly for color themes, thresholds, and element ordering.

How do I install claude-hud?+

Open the source repository on GitHub and follow its README. claude-hud is a agent — MCP Agents Market links you directly to the official repo.

Is claude-hud free?+

claude-hud is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.

Related searches