Claude Code Enhanced Statusline

🎨 Transform your terminal with 28 atomic components across 1-9 configurable lines
Block metrics • Burn rate monitoring • Cache efficiency • Cost projections • Atomic precision • Clean separators • Rich information display • Stunning themes • Real-time monitoring • MCP integration • Islamic prayer times • Ultimate customization

🎥 Live Demo & Screenshots

🎨 Catppuccin Mocha Theme in VS Code Terminal

🚀 Installation (2 minutes)

📋 Platform Requirements: 100% compatible across all major platforms

• macOS (12+): brew install jq curl
• Ubuntu/Debian: sudo apt install jq curl
• Arch Linux: sudo pacman -S jq curl
• Fedora/RHEL: sudo dnf install jq curl
• Alpine Linux: apk add jq curl
• Windows: WSL recommended with Ubuntu distribution

Choose your preferred installation method:

Option 1: Quick Install (Recommended)

# Download and inspect the installer (strongly recommended)
curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh -o install.sh

# Review what it does - look for:
# ✓ Only creates files in ~/.claude/statusline/
# ✓ Downloads from this GitHub repo
# ✓ No sudo or system modifications
less install.sh  

# Run when you're satisfied it's safe
bash install.sh

🔍 Quick Security Check: Open install.sh and verify it only:

• Creates directories in ~/.claude/
• Downloads files from raw.githubusercontent.com/rz1989s/claude-code-statusline
• Doesn't use sudo or modify system files
• Uses curl with proper GitHub raw URLs
• No network calls to external domains

Option 1b: One-Line Install (Trust the Repo)

# Direct install without inspection (for trusted users)
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash

🔍 Enhanced Installer Options

# Check all dependencies (shows 6 feature categories)
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --check-all-deps

# Interactive installation with user choices
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --interactive

# Comprehensive dependency analysis + interactive mode
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --check-all-deps --interactive

# Install from development branch
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/nightly/install.sh | bash -s -- --branch=nightly

# Debug installation issues
STATUSLINE_INSTALL_DEBUG=true curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash

Option 2: Manual Install (No script required)

# 1. Create directory structure
mkdir -p ~/.claude/statusline/{lib,examples}

# 2. Download core files
curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/statusline.sh -o ~/.claude/statusline/statusline.sh
curl -fsSL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/examples/Config.toml -o ~/.claude/statusline/Config.toml

# 3. Download library modules (automated)
curl -sSfL https://raw.githubusercontent.com/rz1989s/claude-code-statusline/main/install.sh | bash -s -- --modules-only

# 4. Make executable and test
chmod +x ~/.claude/statusline/statusline.sh
~/.claude/statusline/statusline.sh --version

✅ Verify Installation Success

# Confirm installation success
~/.claude/statusline/statusline.sh --version
ls -la ~/.claude/statusline/lib/  # Should show 10+ module files

# Test with sample input
echo '{"workspace": {"current_dir": "'"$(pwd)"'"}, "model": {"display_name": "Test"}}' | ~/.claude/statusline/statusline.sh

What Does This Install?

🔍 Transparency First - Here's exactly what happens:

✅ Creates one directory: ~/.claude/statusline/ (in your home folder only)
✅ Downloads 31 text files: Shell scripts from this GitHub repository
✅ Creates one config file: Config.toml with default settings you can edit
✅ No system changes: Everything stays in your home folder

❌ Does NOT:

• Modify any system files or PATH
• Install packages globally or change your OS
• Require admin/sudo permissions
• Send data anywhere or phone home
• Modify your shell config (.bashrc, .zshrc, etc.)

🔐 Security: All files are downloaded from this public GitHub repository - you can inspect every line of code before running.

📚 Table of Contents

• Installation
• Recent Updates
• Features
• Theme Gallery
• Screenshot Showcase
• Advanced Setup
• Configuration
• What Each Line Shows
• System Requirements
• Documentation
• Contributing
  • Development Setup
  • Testing
• License
• Acknowledgments

🆕 Recent Updates

v2.10.0 - Advanced Block Metrics Integration 🔥📊 LATEST

🚀 REVOLUTIONARY BLOCK METRICS SYSTEM

• 4 NEW Block Metrics Components - 100% native cost calculation with 75% resource reduction
• Unified Data Collection - Single API call feeds all metrics (burn rate, tokens, cache efficiency, projections)
• Burn Rate Monitoring - Critical token consumption tracking (🔥3.5k/min $2.10/hr)
• Cache Efficiency - Performance optimization insights (Cache: 94% hit)
• Cost Projections - Budget planning and limit avoidance (Est: $16.48)
• Resource Optimized - Minimal background processes, smart 30s caching

v2.9.0 - Revolutionary 3-Tier Download System 🚀⚡

🚀 REVOLUTIONARY INSTALLER OVERHAUL

• 3-Tier Download Architecture - Complete installer architectural overhaul eliminates GitHub rate limits forever
• Tier 1: Direct Raw URLs - Unlimited requests, no API usage, fastest installation method (handles 99% of cases)
• Tier 2: GitHub API Fallback - Optional token support increases limits from 60/hour to 5,000/hour
• Tier 3: Comprehensive Retry - Exponential backoff and intelligent verification with detailed troubleshooting
• 100% Download Guarantee - Either all modules download successfully or clear failure with actionable guidance
• Zero Intervention Required - Primary method handles installations automatically without user interaction

⚡ INSTALLATION IMPROVEMENTS

• Eliminates GitHub Rate Limits - Direct raw URLs bypass API limitations completely
• Enhanced Error Handling - Exponential backoff and comprehensive retry mechanisms
• Performance Benefits - Fastest installation method using direct raw URLs
• Backward Compatible - All existing installation methods preserved and enhanced

🐛 ADDITIONAL FIXES

• Fixed Prayer Time Calculation - Resolved "24h 0m" display bug, now shows "(0m)" for exact matches
• Enhanced Test Coverage - Added comprehensive test cases for prayer time edge scenarios

📈 IMPACT: Bulletproof installation system - Reliable, fast installation regardless of GitHub API availability, with 100% download guarantee and zero user intervention required.

v2.8.0 - Single Source Configuration Revolution 🧹🎯

🎯 REVOLUTIONARY SIMPLIFICATION: SINGLE SOURCE OF TRUTH ARCHITECTURE

Transform your configuration experience with the most significant architectural simplification ever:

• 🧹 Configuration Breakthrough - Eliminated triple redundancy system:

  • ❌ Before: 13 example configs + hardcoded defaults + jq fallbacks = chaos
  • ✅ After: ONE comprehensive Config.toml with all 227 settings = clarity

• 🎯 Zero Hunting - All parameters pre-filled in Config.toml, just edit values

• 🔧 Zero Code Defaults - No more DEFAULT_CONFIG_* constants scattered in lib/config.sh

• ⚡ Pure Extraction - No