Claude Code HUD: Terminal Dashboard for Monitoring AI Coding Sessions

What claude-code-hud does

claude-code-hud is a terminal-based dashboard designed specifically for monitoring Claude Code sessions. The developer built it to address two common pain points: constantly running commands like git diff, git status, and cat to check what Claude changed, and not knowing how much context window remained until hitting limits.

Key features

• Context window gauge with color warnings (green → yellow → red)
• 5-hour/weekly usage rate from Anthropic API (actual data, not estimates)
• Interactive file browser with git status colors
• File diff viewer, branch switching, and commit history — all in the terminal

Setup and usage

Install and run with one command: npx claude-code-hud. No configuration required. The tool sits next to your Claude Code session in a separate terminal window.

The developer describes the workflow as: "You're not writing code with Claude Code. You're reviewing. For that, you don't need IntelliJ. You need a lightweight way to see what's changing and how much context you have left."

The project was built with Claude Code and is available on GitHub at https://github.com/letsgojh0810/hud-plugin.