usage-bar

Installs and configures a Claude Code status bar showing rate limits and context usage.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/prabaljainn/my-claude-code-setup --skill usage-bar-prabaljainn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: usage-bar
Source: https://github.com/prabaljainn/my-claude-code-setup/tree/main/claude/skills/usage-bar
Command: npx skills add https://github.com/prabaljainn/my-claude-code-setup --skill usage-bar-prabaljainn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Claude Code users have no built-in visibility into their 5-hour and 7-day rate limits or current session context usage, making it hard to know when they are approaching a limit. ## Core Features & Use Cases - Status Bar Installation: Copies the statusline-usage.sh script to ~/.claude and registers it in settings.json as the statusLine command. - Live Usage Display: Renders colored progress bars for 5-hour and 7-day rate limits, session context percentage, and reset countdowns. - Multi-language Support: Switch the bar's display language between English and Italian via ~/.claude/usage-bar.conf or the USAGE_BAR_LANG environment variable. - Use Case: A developer on a Claude Pro plan wants to see how close they are to the weekly limit at a glance, so they install the bar and watch the 7d indicator turn orange as usage crosses 80%. ## Quick Start Ask Claude to install the usage status bar and show a live preview of my current rate limits.

Frequently Asked Questions about usage-bar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a usage status bar to Claude Code?▼

Run the usage-bar skill, which copies statusline-usage.sh to ~/.claude, marks it executable, and registers it as the statusLine command in ~/.claude/settings.json. Restart Claude Code afterward to see the bar.

How do I change the Claude Code status bar language?▼

Edit the LANG value in ~/.claude/usage-bar.conf, for example setting LANG=it for Italian, or set the USAGE_BAR_LANG environment variable per session. The change takes effect on the next response without a restart.

What does the Claude Code usage bar display?▼

It shows three colored progress bars: the 5-hour rate limit, the 7-day rate limit, and the current session's context window percentage, plus a countdown to the next limit reset. Colors shift from green to orange to red as usage rises.

Why does the usage bar show N/A for rate limits?▼

Rate limit data is only available with a Claude.ai Pro or Max plan. On plans without that data, the 5h and 7d fields render as N/A while the context window indicator still works.

Does the usage bar work on Windows or Linux?▼

Yes, the script works on macOS, Linux, and Windows via Git Bash or WSL. It auto-detects a Python 3 interpreter from several common paths and forces UTF-8 output on Windows to avoid encoding errors.