chore: bump VERSION to 5.1.0

Author: benabraham

CLAUDE.md

@@ -41,7 +41,7 @@ Key sections in `claude-code-status-line.py` (~2,200 lines):
 - **Lines ~170-355**: Theme system — `THEMES` dict (dark/light, Nord-inspired), `_load_custom_theme()` loads optional `~/.claude/claude-code-theme.toml` via `tomllib`
 - **Lines ~468**: `get_git_branch()` — subprocess call to `git branch --show-current`, strips ESC characters from output
 - **Lines ~497**: `get_git_status()` — collects working directory state (staged/modified/deleted/renamed/untracked/conflicted), stash count, and ahead/behind status via `git status --porcelain=v1`, `git stash list`, and `git rev-list`
-- **Lines ~571**: `fetch_usage_data()` — OAuth API call via `curl` subprocess, cached atomically to `~/.claude/.usage_cache.json` for `USAGE_CACHE_DURATION` seconds
+- **Lines ~571**: `_normalize_usage_data()` — converts CC 2.1.80+ `rate_limits` stdin JSON (unix timestamps, float percentages) to internal format (ISO 8601, utilization). `fetch_usage_data()` (deprecated) — OAuth API fallback for older CC versions, cached atomically to `~/.claude/.usage_cache.json`
 - **Lines ~639-746**: Update checker — `get_installed_version()` runs `claude --version`, `fetch_latest_version()` queries npm registry with caching to `~/.claude/.update_cache.json`, `check_for_update()` compares versions via `parse_semver()`
 - **Lines ~749-870**: Usage gauge rendering — vertical (block chars ▁▂▃▄▅▆▇█) and horizontal blocks styles with forward-looking ratio logic
 - **Lines ~872**: `format_usage_indicators()` — returns dict with per-window usage strings
@@ -70,7 +70,8 @@ Key sections in `claude-code-status-line.py` (~2,200 lines):
 - **Custom themes**: loaded via `tomllib` from a TOML file (Python 3.11+, `tomli` fallback), only the defined keys override the base theme. Silently skipped if no TOML parser available.
 - **Progress bar precision**: Unicode fractional blocks (▏▎▍▌▋▊▉█) for sub-character precision with gradient color interpolation across 10 thresholds.
 - **Input validation**: OAuth token characters allowlisted before HTTP use. Git branch names stripped of ESC chars. Segment widths capped at 128. Hex colors length-checked. Usage ratio guarded against near-zero divisor.
-- **Credential sources**: macOS Keychain (`security` command) → `~/.claude/.credentials.json` fallback.
+- **Usage data source**: CC 2.1.80+ sends `rate_limits` in stdin JSON (preferred). Falls back to deprecated OAuth API (`fetch_usage_data()`) for older CC versions. OAuth path (`get_oauth_token()`, `USAGE_CACHE_PATH`, `SL_USAGE_CACHE_DURATION`) will be removed in a future version.
+- **Credential sources**: macOS Keychain (`security` command) → `~/.claude/.credentials.json` fallback (deprecated, only used by OAuth fallback).
 - **Cache writes**: atomic via `tempfile.mkstemp()` + `os.replace()` with temp file cleanup on failure.
 - **No type hints** per project convention — uses f-strings throughout.
 - **Effort level limitations**: The statusline JSON from Claude Code does NOT include effort level. The `model:effort` option reads from settings files as a workaround. Known gaps:

claude-code-status-line.py

@@ -35,7 +35,7 @@
 import tty
 from datetime import datetime, timezone
 
-VERSION = "5.0.0"
+VERSION = "5.1.0"
 
 # =============================================================================
 # CONFIGURATION — override any setting via environment variables (SL_ prefix)
@@ -55,6 +55,7 @@ def _env_int(key, default):
 
 
 THEME = _env_str("THEME", "dark")
+# Deprecated: only used by fetch_usage_data() fallback. Will be removed in a future version.
 USAGE_CACHE_DURATION = _env_int("USAGE_CACHE_DURATION", 300)
 UPDATE_CACHE_DURATION = _env_int("UPDATE_CACHE_DURATION", 3600)  # 1 hour on success
 UPDATE_RETRY_DURATION = _env_int("UPDATE_RETRY_DURATION", 600)  # 10 min retry on failure
@@ -623,8 +624,37 @@ def get_git_status(cwd):
 CREDENTIALS_PATH = os.path.expanduser("~/.claude/.credentials.json")
 
 
+def _normalize_usage_data(rate_limits):
+    """Convert rate_limits from CC stdin JSON to internal usage format.
+
+    CC 2.1.80+ sends: {used_percentage: float, resets_at: unix_timestamp}
+    Internal format:  {utilization: int, resets_at: ISO8601_string}
+    """
+    if not rate_limits:
+        return None
+    result = {}
+    for key in ("five_hour", "seven_day"):
+        window = rate_limits.get(key)
+        if not window:
+            continue
+        used_pct = window.get("used_percentage")
+        resets_at = window.get("resets_at")
+        if used_pct is None or resets_at is None:
+            continue
+        reset_dt = datetime.fromtimestamp(resets_at, tz=timezone.utc)
+        result[key] = {
+            "utilization": used_pct,
+            "resets_at": reset_dt.isoformat(),
+        }
+    return result if result else None
+
+
 def get_oauth_token():
-    """Get OAuth access token from macOS Keychain or credentials file."""
+    """Get OAuth access token from macOS Keychain or credentials file.
+
+    Deprecated: Only used by fetch_usage_data() which is itself deprecated.
+    Will be removed in a future version.
+    """
     # On macOS, try Keychain first
     if sys.platform == "darwin":
         try:
@@ -656,7 +686,12 @@ def get_oauth_token():
 
 
 def fetch_usage_data():
-    """Fetch usage data from Anthropic OAuth API, with caching."""
+    """Fetch usage data from Anthropic OAuth API, with caching.
+
+    Deprecated: CC 2.1.80+ provides rate_limits in stdin JSON. This function
+    is kept as a fallback for older CC versions and will be removed in a
+    future version along with get_oauth_token() and USAGE_CACHE_PATH.
+    """
     # Check cache first
     try:
         if os.path.exists(USAGE_CACHE_PATH):
@@ -2199,8 +2234,12 @@ def main():
         return
     pct = int(used_percentage)
 
-    # Get usage limits indicators
-    usage_data = fetch_usage_data()
+    # Get usage limits indicators (prefer stdin from CC 2.1.80+, fallback to OAuth API)
+    rate_limits = data.get("rate_limits")
+    if rate_limits:
+        usage_data = _normalize_usage_data(rate_limits)
+    else:
+        usage_data = fetch_usage_data()  # Deprecated: will be removed in a future version
     usage_parts = format_usage_indicators(usage_data)
 
     # Check for updates