Claude-hud is a heads-up display for monitoring AI agent activity, LLM session metrics, and project environment states. It provides a real-time visual interface to track token usage, context window health, API rate limits, and the activity of active sub-agents and tools.
The project distinguishes itself by parsing session transcripts to extract task progress and tool execution status, converting todo lists into visual completion counters. It also includes a project configuration auditor that visualizes the number of active rules, hooks, and servers defined in the environment.
Beyond agent observability, the system integrates version control tracking to display branch names, commit offsets, and file diffs. It features a token usage visualizer with color-coded progress bars and session cost calculators based on API quota snapshots.
Users can adjust the display layout, visual styles, and semantic lines through configuration files or interactive in-app commands.
