claude-hud
A Claude Code plugin that shows what's happening - context usage, active tools, running agents, and todo progress
claude-hud is a Claude Code plugin that displays real-time session information directly in your terminal statusline. It shows context window usage, token consumption, active tools, running agents, todo progress, and subscriber rate limits without requiring a separate window or tmux. The plugin uses Claude Code's native statusline API to provide always-visible monitoring below your input prompt, helping you track resource usage and activity before hitting limits. Configuration is handled through an interactive setup command that lets you customize which metrics appear and how they're displayed.
Key Features
Use Cases
- 01Monitor context window usage in real-time to prevent hitting limits during long coding sessions
- 02Track subscriber rate limits to know when your 5-hour or weekly quota will reset
- 03Watch which files and tools Claude is accessing during complex refactoring tasks
- 04Monitor sub-agent activity and duration when running parallel research or exploration tasks
- 05Keep track of session costs across multiple conversations throughout the day
- 06Display git repository status and branch information alongside Claude Code activity
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
claude-hud — FAQ
What is claude-hud?+
claude-hud is a Claude Code plugin that displays a heads-up display in your terminal statusline, showing context usage, active tools, running agents, subscriber rate limits, and other session metrics in real-time.
How do I install claude-hud?+
Inside a Claude Code session, run '/plugin marketplace add jarrodwatts/claude-hud', then '/plugin install claude-hud', followed by '/reload-plugins'. Finally, run '/claude-hud:setup' to configure the statusline. The HUD appears after your next message.
Which clients does claude-hud work with?+
claude-hud is specifically designed for Claude Code v1.0.80 and later. It uses Claude Code's native statusline API and does not work with other AI clients like Claude Desktop or ChatGPT.
Does claude-hud require an API key or subscription?+
No API key is required. Usage limit displays work automatically for Claude subscriber accounts. API-key-only users won't see rate limit information but all other features (context, tools, agents, git status) work normally.
Is claude-hud free to use?+
Yes, claude-hud is open source and released under the MIT license. It's completely free to install and use.
What are the prerequisites for running claude-hud?+
You need Claude Code v1.0.80 or later and Node.js 18+ (or Bun on macOS/Linux). Windows users must have Node.js LTS installed for the setup script to run.
How do I install claude-hud?+
Open the source repository on GitHub and follow its README. claude-hud is a plugin — 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.