How do I install the Usage HUD skill?

You can install or repair the HUD statusline by running the /cap:setup command directly within the Claude Code interface.

How can I resolve API 429 errors when using the HUD?

If you hit rate limits, you can increase the CACHE_TTL_MS value in the usage-hud.mjs script to reduce the frequency of usage API requests.

What do the different colors in the HUD represent?

The HUD uses green for usage under 50%, yellow for 50-84%, and red for 85% or higher to provide immediate visual feedback on your allowance status.

Can I customize the progress bar width?

Yes, the progress bar width can be adjusted by changing the width parameter in the progressBar calls within the skill configuration.

Usage HUD for Claude Code

Name: Usage HUD for Claude Code
Author: PeterCha90

byPeterCha90

•

分析与监控

Monitors and displays real-time Claude API usage limits directly within your terminal statusline.

The Usage HUD skill, also known as CAP (Claude Allowance Pulse), provides developers with a persistent visual indicator of their Claude Code resource consumption. By integrating a customizable statusline display, it allows users to track their API allowance through color-coded progress bars and diagnostic commands, ensuring they never hit unexpected rate limits during intensive coding sessions. It includes intelligent caching to prevent API overhead and provides clear visual cues when usage thresholds are reached.

主要功能

01Real-time statusline HUD for token and allowance tracking

02Seamless installation and restoration of previous terminal settings

038 GitHub stars

04Color-coded visual thresholds (Green, Yellow, Red) based on usage percentage

05Quick diagnostic commands for status checks and setup

06Configurable API cache TTL to prevent 429 rate limit errors

使用场景

01Preventing workflow interruptions by monitoring API limits during long development sessions

02Optimizing token usage by visualizing real-time consumption patterns

03Troubleshooting Claude Code connectivity and OAuth token status

主要功能

01Real-time statusline HUD for token and allowance tracking

02Seamless installation and restoration of previous terminal settings

038 GitHub stars

04Color-coded visual thresholds (Green, Yellow, Red) based on usage percentage

05Quick diagnostic commands for status checks and setup

06Configurable API cache TTL to prevent 429 rate limit errors

使用场景

01Preventing workflow interruptions by monitoring API limits during long development sessions

02Optimizing token usage by visualizing real-time consumption patterns

03Troubleshooting Claude Code connectivity and OAuth token status