usage-bar

Install and verify a Claude Code usage status bar with live rendering tests.

1|Updated May 5, 2026
One-click install
npx skills add https://github.com/yashs33244/my-mac-claude --skill usage-bar
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usage-bar
Source: https://github.com/yashs33244/my-mac-claude/tree/main/skills/usage-bar
Command: npx skills add https://github.com/yashs33244/my-mac-claude --skill usage-bar

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you install and verify a persistent Claude Code usage status bar so you can monitor rate limits and context usage without guessing, including a countdown to resets.

Core Features & Use Cases

  • Install or verify the usage bar: Checks for ~/.claude/statusline-usage.sh and ~/.claude/usage-bar.conf, and guides you to set up Claude Code settings.json when missing.
  • Live display testing: Runs a simulated payload to confirm the bar renders correctly and shows both rate limits and context usage.
  • Language switching: Updates the configuration to switch the bar’s display language (e.g., English to Italian) without requiring a restart for the next response.

Quick Start

Ask the skill to install the Claude Code usage status bar and write the default configuration files on your machine.

Frequently Asked Questions about usage-bar

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

FAQPage Schema
How do I show Claude Code rate limits in a status bar?

You can show Claude Code rate limits in a status bar by installing a persistent shell script that parses incoming JSON usage metrics to render a color-coded display of your rate limits and context window usage.

How does the Claude Code usage status bar track context window limits?

The Claude Code usage status bar tracks context window limits by using Python 3 to parse incoming JSON usage metrics, rendering a live, color-coded output that reports both rate limits and context usage alongside a reset countdown.

Do I need Python 3 to monitor Claude Code rate limits locally?

Yes, you need Python 3 execution to monitor Claude Code rate limits locally, as the status bar requires it to parse incoming JSON usage metrics and render the language-aware status output on macOS.

Can I switch the display language of my Claude Code status bar without restarting?

Yes, you can switch the display language of your Claude Code status bar without restarting by updating the local configuration file, which applies the new language like English to Italian on the next response.

How do I verify my Claude Code usage bar is rendering correctly?

You can verify your Claude Code usage bar is rendering correctly by running a simulated payload test, which confirms the bar displays both rate limits and context window usage accurately before live use.

What settings are required to configure a local tooling status bar for Claude Code?

Configuring a local tooling status bar for Claude Code requires setting up the `settings.json` file, along with creating the `statusline-usage.sh` shell script and `usage-bar.conf` configuration file in your `~/.claude` directory.