# jarrodwatts/claude-hud

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/jarrodwatts-claude-hud).**

3,578 stars · 152 forks · JavaScript · mit

## Links

- GitHub: https://github.com/jarrodwatts/claude-hud
- awesome-repositories: https://awesome-repositories.com/repository/jarrodwatts-claude-hud.md

## Topics

`anthropic` `claude` `claude-code` `cli` `plugin` `statusline` `typescript`

## Description

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.

## Tags

### System Administration & Monitoring

- [AI Session Status Lines](https://awesome-repositories.com/f/system-administration-monitoring/status-monitors/oled-status-displays/terminal-status-displays/ai-session-status-lines.md) — Renders a multi-line heads-up display showing model identity, context health, and agent status. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CLAUDE.md))
- [Rate Limit Monitoring Tools](https://awesome-repositories.com/f/system-administration-monitoring/rate-limit-monitoring-tools.md) — Integrates real-time token usage and rate limit status into a visual heads-up display. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CLAUDE.README.md))
- [Agent State Tracking](https://awesome-repositories.com/f/system-administration-monitoring/system-activity-monitoring/session-activity-monitors/agent-state-tracking.md) — Provides real-time tracking of an AI agent's internal behavioral states and activity during a session. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CLAUDE.README.md))
- [AI Agent Activity Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-activity-monitoring/session-activity-monitors/ai-agent-activity-monitors.md) — Provides a real-time monitor for active sub-agents, tool execution status, and task progress.
- [Context Usage Monitors](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/context-usage-monitors.md) — Provides a visual interface for monitoring token consumption, context window health, and rate limits.
- [Real-Time Session Monitors](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/token-usage-analytics/real-time-session-monitors.md) — Monitors real-time token consumption, context window fullness, and cost for LLM sessions.
- [Task Progress Monitors](https://awesome-repositories.com/f/system-administration-monitoring/activity-monitors/activity-progress-monitors/task-progress-monitors.md) — Provides a live view of todo-list completion status to track the advancement of complex goals. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/README.zh.md))
- [Usage Monitors](https://awesome-repositories.com/f/system-administration-monitoring/usage-limiters/usage-monitors.md) — Provides visual indicators for token consumption and API usage quotas using local snapshots. ([source](https://github.com/jarrodwatts/claude-hud#readme))
- [Token Cost Calculators](https://awesome-repositories.com/f/system-administration-monitoring/usage-monitoring/token-usage-analytics/token-cost-calculators.md) — Calculates the financial cost of LLM sessions by applying model pricing to token counts. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CHANGELOG.md))

### User Interface & Experience

- [Heads-Up Displays](https://awesome-repositories.com/f/user-interface-experience/heads-up-displays.md) — Provides a persistent informational overlay that displays real-time session metrics and system state.
- [Token Consumption Progress Bars](https://awesome-repositories.com/f/user-interface-experience/color-systems/color-rendering-adjustments/token-consumption-progress-bars.md) — Renders color-coded progress bars and calculates costs for monitoring context window consumption.
- [Interface Layout Configurations](https://awesome-repositories.com/f/user-interface-experience/interface-layout-configurations.md) — Provides configuration files to toggle interface elements and adjust labeling for the visual environment. ([source](https://github.com/jarrodwatts/claude-hud#readme))
- [Interface Layout Customization](https://awesome-repositories.com/f/user-interface-experience/interface-layout-customization.md) — Provides settings for defining the visual structure, color presets, and layout of the interface. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CHANGELOG.md))

### Artificial Intelligence & ML

- [Agent Observability Tools](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-observability-tools.md) — Visualizes active sub-agents, running tools, and task progress to understand the AI session state.
- [Tool Execution Observers](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-observability-tools/tool-execution-observers.md) — Visualizes individual tool call executions, such as file reads and edits, as they occur. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/README.zh.md))
- [Project Context Rules](https://awesome-repositories.com/f/artificial-intelligence-ml/generative-ai-configurations/project-context-rules.md) — Monitors active project rules and hooks to ensure the AI has the correct environment setup.
- [Session Transcript Parsing](https://awesome-repositories.com/f/artificial-intelligence-ml/session-transcript-parsing.md) — Extracts tool activity and task progress by scanning session transcripts for specific patterns.
- [Snapshot-Based Quota Estimation](https://awesome-repositories.com/f/artificial-intelligence-ml/usage-quotas/snapshot-based-quota-estimation.md) — Maintains local copies of API usage data to estimate rate limits and token consumption.
- [Usage Quotas](https://awesome-repositories.com/f/artificial-intelligence-ml/usage-quotas.md) — Monitors spending and usage limits for AI services using live input streams. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/README.md))

### Development Tools & Productivity

- [Configuration Auditing](https://awesome-repositories.com/f/development-tools-productivity/project-configuration-utilities/configuration-auditing.md) — Counts and displays the number of active servers, hooks, and rules defined in configuration files. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CLAUDE.README.md))
- [Configuration Visualization](https://awesome-repositories.com/f/development-tools-productivity/project-configuration/configuration-visualization.md) — Visualizes the number of active rules, hooks, and servers defined in project configuration files.
- [Repository State Monitoring](https://awesome-repositories.com/f/development-tools-productivity/git-repository-integrators/git-repository-integrators/repository-state-monitoring.md) — Monitors root paths and head status to provide real-time Git repository metadata in the display.
- [Interactive Command Interfaces](https://awesome-repositories.com/f/development-tools-productivity/interactive-command-interfaces.md) — Allows adjusting display preferences and settings through an interactive in-app command interface. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CHANGELOG.md))
- [Task Progress Indicators](https://awesome-repositories.com/f/development-tools-productivity/task-progress-indicators.md) — Extracts task lists from session calls and visualizes completion counts against total items. ([source](https://github.com/jarrodwatts/claude-hud/blob/main/CLAUDE.md))

### Security & Cryptography

- [Session Task Tracking](https://awesome-repositories.com/f/security-cryptography/process-sandboxes/session-resumption/ai-agent-sessions/session-task-tracking.md) — Converts session todo lists into visual completion counters to track the advancement of goals.

### DevOps & Infrastructure

- [Git Status Indicators](https://awesome-repositories.com/f/devops-infrastructure/version-control-management/version-control-integrations/git-status-indicators.md) — Displays branch names, commit offsets, and file modification states as visual cues.