ccburn 0.1.7__py3-none-any.whl → 0.2.1__py3-none-any.whl

ccburn/data/credentials.py

@@ -2,6 +2,8 @@
 
 import json
 import os
+import platform
+import subprocess
 from datetime import datetime, timezone
 from pathlib import Path
 
@@ -44,32 +46,81 @@ def get_credentials_path() -> Path:
     return Path.home() / ".claude" / ".credentials.json"
 
 
-def read_credentials() -> dict:
-    """Read the raw credentials file.
+def _read_credentials_from_keychain() -> dict | None:
+    """Read credentials from macOS Keychain.
 
     Returns:
-        Parsed credentials dictionary
+        Parsed credentials dictionary or None if not found/failed.
+    """
+    try:
+        result = subprocess.run(
+            ["security", "find-generic-password", "-s", "Claude Code-credentials", "-w"],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        return json.loads(result.stdout.strip())
+    except (subprocess.CalledProcessError, json.JSONDecodeError, FileNotFoundError):
+        return None
 
-    Raises:
-        CredentialsNotFoundError: If file doesn't exist
-        InvalidCredentialsError: If file is malformed
+
+def _read_credentials_from_file() -> dict | None:
+    """Read credentials from file.
+
+    Returns:
+        Parsed credentials dictionary or None if not found/failed.
     """
     creds_path = get_credentials_path()
 
     if not creds_path.exists():
-        raise CredentialsNotFoundError(
-            f"Credentials file not found at {creds_path}\n"
-            "Please ensure Claude Code is installed and you are logged in.\n"
-            "Run 'claude' to log in if needed."
-        )
+        return None
 
     try:
         with open(creds_path) as f:
             return json.load(f)
-    except json.JSONDecodeError as e:
-        raise InvalidCredentialsError(f"Invalid JSON in credentials file: {e}") from e
-    except PermissionError as e:
-        raise CredentialsError(f"Permission denied reading {creds_path}") from e
+    except (json.JSONDecodeError, PermissionError):
+        return None
+
+
+def read_credentials() -> dict:
+    """Read credentials from the appropriate storage.
+
+    On macOS, tries Keychain first, then falls back to file.
+    On Linux/Windows, reads from file.
+
+    Returns:
+        Parsed credentials dictionary
+
+    Raises:
+        CredentialsNotFoundError: If credentials not found
+        InvalidCredentialsError: If credentials are malformed
+    """
+    credentials = None
+
+    # On macOS, try Keychain first
+    if platform.system() == "Darwin":
+        credentials = _read_credentials_from_keychain()
+
+    # Fall back to file (or use file on non-macOS)
+    if credentials is None:
+        credentials = _read_credentials_from_file()
+
+    if credentials is None:
+        creds_path = get_credentials_path()
+        if platform.system() == "Darwin":
+            raise CredentialsNotFoundError(
+                "Credentials not found in macOS Keychain or file.\n"
+                "Please ensure Claude Code is installed and you are logged in.\n"
+                "Run 'claude' to log in if needed."
+            )
+        else:
+            raise CredentialsNotFoundError(
+                f"Credentials file not found at {creds_path}\n"
+                "Please ensure Claude Code is installed and you are logged in.\n"
+                "Run 'claude' to log in if needed."
+            )
+
+    return credentials
 
 
 def check_token_expired(credentials: dict) -> bool:

ccburn/display/chart.py

@@ -10,8 +10,10 @@ from rich.jupyter import JupyterMixin
 
 try:
     from ..data.models import LimitData, UsageSnapshot
+    from ..utils.formatting import get_utilization_color
 except ImportError:
     from ccburn.data.models import LimitData, UsageSnapshot
+    from ccburn.utils.formatting import get_utilization_color
 
 
 class BurnupChart(JupyterMixin):
@@ -143,8 +145,11 @@ class BurnupChart(JupyterMixin):
                     values.append(util_pct)
 
             if times:
-                # Determine line color based on current utilization
-                color = self._get_plotext_color(self.limit_data.utilization)
+                # Calculate budget pace for color determination
+                elapsed_hours = (now - original_window_start).total_seconds() / 3600
+                budget_pace = min(elapsed_hours / original_window_hours, 1.0)
+                # Determine line color based on utilization AND burn rate
+                color = self._get_plotext_color(self.limit_data.utilization, budget_pace)
                 # Use fillx=True for area chart effect (fills down to x-axis)
                 plt.plot(
                     times,
@@ -258,23 +263,27 @@ class BurnupChart(JupyterMixin):
 
         return plt.build()
 
-    def _get_plotext_color(self, utilization: float) -> tuple[int, int, int]:
-        """Get plotext RGB color based on utilization.
+    def _get_plotext_color(
+        self, utilization: float, budget_pace: float = 0.0
+    ) -> tuple[int, int, int]:
+        """Get plotext RGB color based on utilization and burn rate.
 
         Args:
             utilization: Current utilization (0-1)
+            budget_pace: How much of window has elapsed (0-1)
 
         Returns:
             RGB tuple for plotext - bright vivid colors matching Rich progress bars
         """
-        if utilization < 0.5:
-            return (0, 255, 0)  # Bright green
-        elif utilization < 0.75:
-            return (255, 255, 0)  # Bright yellow
-        elif utilization < 0.9:
-            return (255, 165, 0)  # Orange
-        else:
-            return (255, 0, 0)  # Bright red
+        # Reuse shared color logic, map Rich color names to RGB
+        color_name = get_utilization_color(utilization, budget_pace)
+        color_map = {
+            "green": (0, 255, 0),
+            "yellow": (255, 255, 0),
+            "bright_red": (255, 165, 0),  # Orange
+            "red": (255, 0, 0),
+        }
+        return color_map.get(color_name, (255, 255, 0))
 
 
 def create_simple_chart(

ccburn/display/gauges.py

@@ -110,9 +110,9 @@ def create_gauge_section(
     utilization_percent = limit_data.utilization * 100
     pace_percent = budget_pace * 100
 
-    # Usage bar - color by threshold
+    # Usage bar - color by threshold AND burn rate
     # complete_style = filled portion (bright), style = unfilled portion (dim)
-    usage_color = get_utilization_color(limit_data.utilization)
+    usage_color = get_utilization_color(limit_data.utilization, budget_pace)
     usage_bar = ProgressBar(
         total=100,
         completed=utilization_percent,
@@ -120,15 +120,9 @@ def create_gauge_section(
         complete_style=Style(color=usage_color),  # Bright color for filled
     )
 
-    # Usage label with emoji based on status
-    usage_emoji = "📊"
-    if limit_data.utilization >= 0.9:
-        usage_emoji = "🚨"
-    elif limit_data.utilization >= 0.75:
-        usage_emoji = "⚠️"
-
+    # Usage label - keep emoji consistent (⚠️ has inconsistent width across terminals)
     usage_label = Text()
-    usage_label.append(f"{usage_emoji} ", style="")
+    usage_label.append("📊 ", style="")
     usage_label.append("Usage", style=f"bold {usage_color}")
 
     table.add_row(

ccburn/utils/formatting.py

@@ -82,28 +82,50 @@ def format_reset_time(resets_at: datetime, now: datetime | None = None) -> str:
     # Convert to local time for display
     local_time = resets_at.astimezone()
     day_name = local_time.strftime("%a")  # "Tue"
-    time_str = local_time.strftime("%-I:%M %p")  # "4:00 PM"
+    # Use %I and strip leading zero (%-I is Unix-only, %#I is Windows-only)
+    time_str = local_time.strftime("%I:%M %p").lstrip("0")  # "4:00 PM"
     return f"Resets {day_name} {time_str}"
 
 
-def get_utilization_color(utilization: float) -> str:
-    """Get color based on utilization percentage.
+def get_utilization_color(utilization: float, budget_pace: float = 0.0) -> str:
+    """Get color based on utilization and burn rate.
 
     Args:
-        utilization: Float between 0 and 1
+        utilization: Current usage (0-1)
+        budget_pace: How much of window has elapsed (0-1)
 
     Returns:
-        Color name: "green", "yellow", "orange", or "red"
+        Color name: "green", "yellow", "bright_red", or "red"
     """
-    if utilization < 0.5:
-        return "green"
-    elif utilization < 0.75:
-        return "yellow"
-    elif utilization < 0.9:
-        return "bright_red"  # Rich uses "bright_red" for orange-like
-    else:
+    # Critical: always red at very high utilization
+    if utilization >= 0.9:
         return "red"
 
+    # Calculate burn ratio if we have meaningful data
+    burn_ratio = 1.0
+    if budget_pace >= 0.05 and utilization >= 0.01:
+        burn_ratio = utilization / budget_pace
+
+    # High utilization: at least orange, red if also burning fast
+    if utilization >= 0.75:
+        return "red" if burn_ratio > 1.5 else "bright_red"
+
+    # Moderate utilization: color based on burn rate
+    if utilization >= 0.5:
+        if burn_ratio > 2.0:
+            return "red"
+        if burn_ratio > 1.5:
+            return "bright_red"
+        return "yellow"
+
+    # Low utilization: escalate only if burning very fast
+    if burn_ratio > 3.0:
+        return "bright_red"  # Will hit limit at ~33% of window
+    if burn_ratio > 2.0:
+        return "yellow"  # Will hit limit at ~50% of window
+
+    return "green"
+
 
 def get_status_indicator(utilization: float, budget_pace: float) -> str:
     """Get status indicator for compact output.

{ccburn-0.1.7.dist-info → ccburn-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccburn
-Version: 0.1.7
+Version: 0.2.1
 Summary: Terminal-based Claude Code usage limit visualizer with real-time burn-up charts
 Author: JuanjoFuchs
 License-Expression: MIT
@@ -41,11 +41,12 @@ Dynamic: license-file
 
 [![CI](https://img.shields.io/github/actions/workflow/status/JuanjoFuchs/ccburn/ci.yml?branch=main&label=CI)](https://github.com/JuanjoFuchs/ccburn/actions/workflows/ci.yml)
 [![Release](https://img.shields.io/github/actions/workflow/status/JuanjoFuchs/ccburn/release.yml?label=Release)](https://github.com/JuanjoFuchs/ccburn/actions/workflows/release.yml)
+[![npm](https://img.shields.io/npm/v/ccburn)](https://www.npmjs.com/package/ccburn)
 [![PyPI](https://img.shields.io/pypi/v/ccburn)](https://pypi.org/project/ccburn/)
 [![Python](https://img.shields.io/pypi/pyversions/ccburn)](https://pypi.org/project/ccburn/)
 [![GitHub Release](https://img.shields.io/github/v/release/JuanjoFuchs/ccburn)](https://github.com/JuanjoFuchs/ccburn/releases)
 [![WinGet](https://img.shields.io/badge/WinGet-pending-yellow)](https://github.com/microsoft/winget-pkgs/pulls?q=is%3Apr+ccburn)
-[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE)
+[![License](https://img.shields.io/github/license/JuanjoFuchs/ccburn)](LICENSE)
 
 <p align="center">
   <img src="docs/cash1.png" alt="Burning tokens" width="140">
@@ -70,13 +71,27 @@ TUI and CLI for Claude Code usage limits — burn-up charts, compact mode for st
 
 ## Installation
 
-### Windows (WinGet) — *pending approval*
+Run `claude` and login first to refresh credentials.
+
+### WinGet (*pending approval*)
 
 ```powershell
 winget install JuanjoFuchs.ccburn
 ```
 
-### Cross-Platform (pip)
+### npx
+
+```bash
+npx ccburn
+```
+
+### npm
+
+```bash
+npm install -g ccburn
+```
+
+### pip
 
 ```bash
 pip install ccburn
@@ -92,7 +107,10 @@ pip install -e ".[dev]"
 
 ## Quick Start
 
-1. **Ensure Claude Code is installed** — ccburn reads credentials from Claude Code's config
+1. **Run Claude Code first** to ensure credentials are fresh:
+   ```bash
+   claude
+   ```
 2. **Run ccburn:**
    ```bash
    ccburn              # Session limit (default)

{ccburn-0.1.7.dist-info → ccburn-0.2.1.dist-info}/RECORD

@@ -3,20 +3,20 @@ ccburn/app.py,sha256=FcVHLbnygKbMTGIFZRN5jS_Pve8VdKImfLi2KsDuEoU,15510
 ccburn/cli.py,sha256=5qYYmOWcUXNYEdK-E3DBixfWQK4wKIQs6FPvTrIfOVI,7184
 ccburn/main.py,sha256=TqWLl9xxOtbpTQr-ObomzSLG3jNec2GZ6RKEQYYdGLg,2474
 ccburn/data/__init__.py,sha256=ZczEZwodQ-MMO5F7fVNsyIpUCRY8Ya9W4pwdOOJWxm4,803
-ccburn/data/credentials.py,sha256=PYrgzx-2NyiMTtIwBhulUdKawfT8cvWW4wIw2dOptks,3752
+ccburn/data/credentials.py,sha256=wDiiTkZZDBjnYspvtWJ_52xXdTdIgBndLlfFMi-peZ8,5228
 ccburn/data/history.py,sha256=ouBxrXpMp_eTs0kba1Bg55TI6bsBSMToJ32tH1wNHQI,12879
 ccburn/data/models.py,sha256=Sd2T36gH6OaNHl9zRlnnQXI-ziBA8Gl6rPYQIzmr7G4,5403
 ccburn/data/usage_client.py,sha256=_dGwmI5vYPk4S-HUe2_fnTwSuAfTPaOFff7mKPFnhps,4570
 ccburn/display/__init__.py,sha256=aL7TV53kU5oxlIwJ8M17stG2aC6UeGB-pj2u5BOpegs,495
-ccburn/display/chart.py,sha256=j1qM6YX_K5SfKCxaob3-mT1vJjr8VMdsHIN8ORJu-2c,11421
-ccburn/display/gauges.py,sha256=jkPy3BuPsN1__4Ynt0DxK8t3Su_2jl5HAJifCmdtiiA,8696
+ccburn/display/chart.py,sha256=HGDcMqaqyNtlQzV-d-gUOStq8qjpVt4EYvCIU6BTAx8,11983
+ccburn/display/gauges.py,sha256=DCRunsEtv1HflRkTZLwnNbVZhe47gCIH78p3gfqFwDo,8594
 ccburn/display/layout.py,sha256=UndPxyh32jWGdDgOZCvedz06WcKxYMSchLwpOkkXQKo,8093
 ccburn/utils/__init__.py,sha256=N6EzUX9hUJkuga_l9Ci3of1CWNtQgpNmMmNyY2DgYrg,1119
 ccburn/utils/calculator.py,sha256=QcFm5X-VWZzucHdInEjjqKV5oZaNsdpMgl8oKvHAQYc,6174
-ccburn/utils/formatting.py,sha256=vFpGY8v60G8OjTmZ1I1dYCr3h7YIfB8ezVMICb6RyZk,3327
-ccburn-0.1.7.dist-info/licenses/LICENSE,sha256=Qf2mqNi2qJ35JytfoTdR1SgYhZ2Mt4Ohcf-tu_MuYC0,1068
-ccburn-0.1.7.dist-info/METADATA,sha256=_LEB2WIp8EaFVJnhP8IZdtJz4EybYIzrYZ-L3sGM0jw,6787
-ccburn-0.1.7.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ccburn-0.1.7.dist-info/entry_points.txt,sha256=GfFQ5VusMR8RJ9meygqWjaErdmYsf_arbILzf64WjLU,43
-ccburn-0.1.7.dist-info/top_level.txt,sha256=SM8TwGQZqQKKIQObVWQkfpA0OI4gRut7bPl-iM3g5RI,7
-ccburn-0.1.7.dist-info/RECORD,,
+ccburn/utils/formatting.py,sha256=MEVIohBmvSur0hcc67oyYRDooiUMf0rPa4LO1fc2Ud4,4174
+ccburn-0.2.1.dist-info/licenses/LICENSE,sha256=Qf2mqNi2qJ35JytfoTdR1SgYhZ2Mt4Ohcf-tu_MuYC0,1068
+ccburn-0.2.1.dist-info/METADATA,sha256=gnEPQbkE97in73KUywvp6hF7nrMUzYCG5Lvv1UU06ZI,6979
+ccburn-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ccburn-0.2.1.dist-info/entry_points.txt,sha256=GfFQ5VusMR8RJ9meygqWjaErdmYsf_arbILzf64WjLU,43
+ccburn-0.2.1.dist-info/top_level.txt,sha256=SM8TwGQZqQKKIQObVWQkfpA0OI4gRut7bPl-iM3g5RI,7
+ccburn-0.2.1.dist-info/RECORD,,