A lightweight, highly configurable status-line monitor for Claude Code, designed to provide real-time insights into Anthropic API usage and session metrics. It targets Claude Code users who need immediate visibility into rate-limit consumption, model parameters, and prompt-cache status without leaving their development environment, thereby optimizing API interactions and cost awareness.

How It Works

This project integrates with Claude Code's statusLine hook, leveraging its stdin payload and API headers to display critical data. It employs a Python backend that can run in a low-CPU daemon mode or an inline mode. The system parses API responses for rate-limit percentages and reset timers, extracts model and context window details, and calculates prompt-cache countdowns by analyzing transcript data. Its core advantage lies in presenting complex information concisely on a single line with extensive visual customization.

Quick Start & Requirements

• Primary install: pip install claude-statusbar followed by cs --setup. Restart Claude Code.
• Prerequisites: Claude Code v2.1.80+ and a Python environment.
• Resource Footprint: Daemon mode consumes <1% CPU. Setup involves modifying ~/.claude/settings.json.
• Links: Repository, Changelog

Highlighted Details

• API Rate Limits: Displays rolling 5-hour and 7-day usage percentages with corresponding reset timers.
• Model & Context: Shows the active model (e.g., Opus 4.7) and current context window utilization (e.g., 350.0k/1.0M tokens).
• Prompt Cache: Features an auto-detected prompt-cache countdown (5min/1h TTL) with color-coded urgency, crucial for subscribers to manage quota efficiently.
• Customization: Offers 3 distinct visual styles (classic, capsule, hairline) and 9 themes, configurable via command-line flags or a persistent JSON configuration file.
• Session Metrics: Optionally displays session cost (API-equivalent value), project/branch status, Git ahead/behind counts, session duration, and lines added/removed.
• Activity Tracking: Includes an "activity line" to show in-progress todos, active tools, and completed tool rollups.

Maintenance & Community

The project is actively maintained, with the latest release v3.10.0 on June 2, 2026. Notable contributions include the show_cache_age widget. Community interaction details like Discord/Slack are not explicitly provided in the README.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive for commercial use and integration into closed-source projects. Requires Claude Code v2.1.80+.

Limitations & Caveats

The tool is dependent on the Claude Code environment. Many advanced features, such as session cost, project/branch details, and tool/agent tracking, are opt-in and require explicit configuration. The bar_shimmer feature is experimental.