Claude Statusline

Claude Statusline

A custom statusline for Claude Code 2.x that provides real-time usage tracking with an intelligent multi-layer progress visualization, helping you stay aware of context windows, costs, and session limits.

Features

Core Tracking Features
- 5-hour window tracker - Real-time cost monitoring with burn-rate based projection and 3-layer visualization
- Daily usage tracker - 24-hour cycle aligned with weekly reset, shows % of weekly limit with end-of-day projection
- Weekly usage tracker - Multiple display modes: usage %, available %, or recommended daily usage
- Monthly cost tracker - Total spending from billing cycle start date (configurable)
- Context window tracker - 3-layer visualization showing cached vs fresh tokens, supports extended context (>168k)
- Token burn rate - Real-time tokens/min indicator based on billable tokens
- Session timer - Countdown to next 5-hour window reset with current/reset time display
- Active sessions - Concurrent Claude Code project counter

Advanced Features
- Intelligent weekly calibration - Compensates for untracked costs (deleted transcripts, extended context)
- Multi-layer progression system - Config-driven thresholds with auto-scaled visualization per layer
- Weekly display modes - Choose between usage %, available %, or recommended daily % to finish allocated budget
- Daily projection integration - Combines 5-hour window projection with daily tracking for accurate end-of-day estimates
- Unified cache system - Smart dependency tracking invalidates caches when config changes
- Three-stage pipeline - Clean architecture: Data Collection → Computation → Rendering
- Conditional rendering - Only computes enabled sections for optimal performance
- Modular utilities - Separate layer calculations, caching, and time…