usage-bar

Install and configure a persistent Claude Code usage bar across platforms.

24|8|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/bhutano/claude-usage-bar --skill usage-bar-bhutano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: usage-bar
Source: https://github.com/bhutano/claude-usage-bar/tree/main
Command: npx skills add https://github.com/bhutano/claude-usage-bar --skill usage-bar-bhutano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a one-shot installer and maintenance workflow for Claude Code's usage status bar, simplifying installation, configuration, and activation of a persistent CLI display.

Core Features & Use Cases

  • Automatic installation of status bar (bash script) and optional manual setup.
  • Language configuration and restart guidance for cross-language support.
  • Quick setup to enable a live usage bar in Claude Code across platforms.

Quick Start

Install the status bar with the official installer and restart Claude Code to activate the feature.

Frequently Asked Questions about usage-bar

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

FAQPage Schema
How do I install the Claude Code usage bar to monitor rate limits?

You can install the status bar using the automatic bash installer, which patches the statusLine entry in settings.json, or manually configure the settings.json file to enable the live usage bar.

What prerequisites do I need to configure a persistent status bar in Claude Code?

Configuring the persistent status bar requires a Bash environment with execution permissions, Python 3, and access to the ~/.claude directory and settings.json file to patch the statusLine entry across macOS, Linux, or Windows.

Can I set up the Claude Code status bar on Windows and Linux?

Yes, the status bar setup is cross-platform and supports macOS, Linux, and Windows, requiring a Bash environment and Python 3 to execute the installer and patch the settings.json configuration.

How does the Claude Code usage bar track session context?

The usage bar monitors session context and rate limits by running a persistent bash script that displays live updates directly in the Claude Code CLI status line.

What should I do if the automatic installation for the usage bar fails?

If the automatic installation fails, you can use the manual fallback setup to directly patch the statusLine entry in your settings.json file and then restart Claude Code to activate the status bar.