What versions of Claude Code are supported by Claude HUD?

Claude HUD supports Claude Code version 2.1.6 and higher, with advanced features like turn duration and effective context window optimized for version 2.1.7.

How do I enable the statusline in Claude Code?

You can enable the HUD by adding a statusline configuration object to your .claude/settings.json file with 'enabled': true and a template string.

What happens when my context usage reaches the red threshold?

When usage exceeds 95%, the HUD displays a red alert, signaling that you should immediately use context compression or summarize the conversation to avoid losing information.

Can I track the financial cost of my AI coding session?

Yes, the skill utilizes the session.cost field to display real-time expenditure directly in your terminal statusline.

What is the difference between static max and effective context window?

Static max is the theoretical limit (e.g., 200k tokens), while the effective window is the actual usable space after accounting for system overhead and loaded skills.

Claude HUD

Name: Claude HUD
Author: yonatangross

byyonatangross

•

Analytics & Monitoring

Configures a real-time statusline to monitor context window usage, session costs, and performance metrics within Claude Code.

Claude HUD provides essential observability for developers using Claude Code by transforming the statusline into a dynamic monitoring dashboard. It allows users to track token consumption against effective context limits, monitor real-time session costs, and visualize usage thresholds with color-coded status bars. By integrating version 2.1.7 fields like turn duration and MCP status, this skill ensures developers can optimize their context management, improve prompt engineering, and prevent context-overflow before it impacts model performance.

Key Features

01Real-time context window usage tracking with percentage indicators

02Dynamic session cost and duration monitoring directly in the terminal statusline

03Support for CC 2.1.7 fields including turn duration and effective window size

04Customizable templates for personalized Heads-Up Display (HUD) layouts

0529 GitHub stars

06Color-coded visual thresholds for critical context management alerts

Use Cases

01Tracking API expenditures in real-time to manage development budgets

02Optimizing prompt engineering by observing turn duration and effective window size

03Preventing context loss during long coding sessions by monitoring token limits

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add yonatangross/skillforge-claude-plugin claude-hud

For use in Claude.ai and ChatGPT

Download Skill