cctally 1.62.0 → 1.63.0

package/CHANGELOG.md

@@ -5,6 +5,11 @@ based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.63.0] - 2026-07-07
+
+### Added
+- `cctally statusline --usage-only` renders just the subscription usage chip (`5h X% · 7d Y%`), dropping the model, cost, burn-rate, context, and reset-countdown segments — for users who want a small quota indicator in their prompt without the cost telemetry. Persist it with `cctally config set statusline.usage_only true`; `--no-usage-only` forces the full statusline when the config key is on. Contributed by @nathanm4 (public PR #3).
+
 ## [1.62.0] - 2026-07-06
 
 ### Changed

package/bin/_cctally_config.py

@@ -309,6 +309,7 @@ ALLOWED_CONFIG_KEYS = (
     "statusline.visual_burn_rate",
     "statusline.cost_source",
     "statusline.cctally_extensions",
+    "statusline.usage_only",
     "budget.weekly_usd",
     "budget.alerts_enabled",
     "budget.alert_thresholds",
@@ -379,6 +380,25 @@ def _validate_statusline_cctally_extensions(value):
     )
 
 
+def _validate_statusline_usage_only(value):
+    """Validate ``statusline.usage_only``.
+
+    Accepts booleans (preferred) or canonical truthy/falsy strings
+    (``true``/``false``/``yes``/``no``/``on``/``off``/``1``/``0``).
+    """
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, str):
+        lo = value.strip().lower()
+        if lo in ("true", "yes", "on", "1"):
+            return True
+        if lo in ("false", "no", "off", "0"):
+            return False
+    raise ValueError(
+        f"statusline.usage_only must be boolean (got {value!r})"
+    )
+
+
 def cmd_config(args: argparse.Namespace) -> int:
     """Get/set/unset persisted user preferences in config.json.
 
@@ -544,6 +564,7 @@ def _config_known_value(config: dict, key: str) -> "object":
         "statusline.visual_burn_rate",
         "statusline.cost_source",
         "statusline.cctally_extensions",
+        "statusline.usage_only",
     ):
         sl_block = config.get("statusline") if isinstance(config, dict) else None
         if not isinstance(sl_block, dict):
@@ -554,6 +575,7 @@ def _config_known_value(config: dict, key: str) -> "object":
             "visual_burn_rate": "off",
             "cost_source": "auto",
             "cctally_extensions": True,
+            "usage_only": False,
         }
         if stored is None:
             return defaults[inner]
@@ -561,6 +583,7 @@ def _config_known_value(config: dict, key: str) -> "object":
             "visual_burn_rate": _validate_statusline_visual_burn_rate,
             "cost_source": _validate_statusline_cost_source,
             "cctally_extensions": _validate_statusline_cctally_extensions,
+            "usage_only": _validate_statusline_usage_only,
         }[inner]
         try:
             return validator(stored)
@@ -987,12 +1010,14 @@ def _cmd_config_set(args: argparse.Namespace) -> int:
         "statusline.visual_burn_rate",
         "statusline.cost_source",
         "statusline.cctally_extensions",
+        "statusline.usage_only",
     ):
         inner_key = key.split(".", 1)[1]
         validator = {
             "visual_burn_rate": _validate_statusline_visual_burn_rate,
             "cost_source": _validate_statusline_cost_source,
             "cctally_extensions": _validate_statusline_cctally_extensions,
+            "usage_only": _validate_statusline_usage_only,
         }[inner_key]
         try:
             normalized = validator(raw)
@@ -1390,6 +1415,7 @@ def _cmd_config_unset(args: argparse.Namespace) -> int:
         "statusline.visual_burn_rate",
         "statusline.cost_source",
         "statusline.cctally_extensions",
+        "statusline.usage_only",
     ):
         inner_key = key.split(".", 1)[1]
         with config_writer_lock():

package/bin/_cctally_parser.py

@@ -868,6 +868,21 @@ def _build_statusline_parser(subparsers, name, *, help_text, xref):
         action="store_false",
         help="Suppress cctally 5h%%/7d%% segment.",
     )
+    p.add_argument(
+        "--usage-only",
+        dest="usage_only",
+        action="store_true",
+        default=None,
+        help="Render only subscription usage percentages, e.g. "
+             "`5h 36%% · 7d 35%%` (config key statusline.usage_only).",
+    )
+    p.add_argument(
+        "--no-usage-only",
+        dest="usage_only",
+        action="store_false",
+        help="Render the full statusline even when statusline.usage_only "
+             "is enabled in config.",
+    )
     p.add_argument(
         "--config",
         dest="config",

package/bin/_cctally_statusline.py

@@ -218,6 +218,14 @@ def cmd_statusline(args: argparse.Namespace) -> int:
         )
         ext_on = True
 
+    usage_only = _resolve(args.usage_only, "usage_only", False)
+    if not isinstance(usage_only, bool):
+        warn_once(
+            f"cctally statusline: invalid statusline.usage_only="
+            f"{usage_only!r}; using False"
+        )
+        usage_only = False
+
     tz_name = _resolve_statusline_tz(getattr(args, "timezone", None), cfg, warn_once)
 
     # Color: explicit CLI > NO_COLOR env > TTY detect.
@@ -232,6 +240,7 @@ def cmd_statusline(args: argparse.Namespace) -> int:
         context_low_threshold=int(args.context_low_threshold),
         context_medium_threshold=int(args.context_medium_threshold),
         cctally_extensions=bool(ext_on),
+        usage_only=bool(usage_only),
         color=bool(color),
         display_tz_name=tz_name,
         debug=bool(args.debug),
@@ -634,4 +643,3 @@ def _build_statusline_injections(warn_once):
         warn_once=warn_once,
     )
 
-

package/bin/_lib_statusline.py

@@ -54,6 +54,7 @@ class StatuslineArgs:
     context_low_threshold: int
     context_medium_threshold: int
     cctally_extensions: bool
+    usage_only: bool
     color: bool  # ANSI on/off after auto-detect resolved
     display_tz_name: str  # IANA name; resolved upstream via
                           # get_display_tz_pref(cfg) — defaults to
@@ -372,6 +373,8 @@ def resolve_cctally_extensions(
     inp: StatuslineInput,
     now: datetime,
     inj: StatuslineInjections,
+    *,
+    include_countdowns: bool = True,
 ) -> Optional[str]:
     """Segment 5 — cctally-only `5h X% (...) · 7d Y% (...)`.
 
@@ -411,12 +414,12 @@ def resolve_cctally_extensions(
     parts = []
     if five_pct is not None:
         s = f"5h {int(round(five_pct))}%"
-        if five_resets is not None:
+        if include_countdowns and five_resets is not None:
             s += f" ({_fmt_countdown(five_resets - now_epoch)})"
         parts.append(s)
     if seven_pct is not None:
         s = f"7d {int(round(seven_pct))}%"
-        if seven_resets is not None:
+        if include_countdowns and seven_resets is not None:
             s += f" ({_fmt_countdown(seven_resets - now_epoch)})"
         parts.append(s)
     return " · ".join(parts)
@@ -443,6 +446,19 @@ def _wrap_color(text: str, color: Optional[str], enable: bool) -> str:
 _PERCENT_INT_RE = re.compile(r"(\d+)%")
 
 
+def _colorize_usage_segment(ext: str, args: StatuslineArgs) -> str:
+    """Color a 5h/7d usage segment using the cctally percent bands."""
+    nums = [int(x) for x in _PERCENT_INT_RE.findall(ext)]
+    mx = max(nums) if nums else 0
+    if mx < 60:
+        color = "green"
+    elif mx < 85:
+        color = "yellow"
+    else:
+        color = "red"
+    return _wrap_color(ext, color, args.color)
+
+
 def render_statusline(
     inp: StatuslineInput,
     args: StatuslineArgs,
@@ -453,6 +469,12 @@ def render_statusline(
     None segments (currently only segment 5). See spec §1 for the exact
     layout and §3 for the data flow.
     """
+    if args.usage_only:
+        ext = resolve_cctally_extensions(
+            inp, now, inj, include_countdowns=False
+        )
+        return "" if ext is None else _colorize_usage_segment(ext, args)
+
     seg1 = resolve_model_segment(inp)
 
     # Segment 2: 💰 ... session / ... today / ... block (Xh Ym left)
@@ -486,17 +508,7 @@ def render_statusline(
     if args.cctally_extensions:
         ext = resolve_cctally_extensions(inp, now, inj)
         if ext is not None:
-            # Color by the higher of (5h%, 7d%) using cctally bands:
-            # <60 green, <85 yellow, >=85 red.
-            nums = [int(x) for x in _PERCENT_INT_RE.findall(ext)]
-            mx = max(nums) if nums else 0
-            if mx < 60:
-                color = "green"
-            elif mx < 85:
-                color = "yellow"
-            else:
-                color = "red"
-            seg5 = _wrap_color(ext, color, args.color)
+            seg5 = _colorize_usage_segment(ext, args)
 
     segs = [seg1, seg2, seg3, seg4]
     if seg5 is not None:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cctally",
-  "version": "1.62.0",
+  "version": "1.63.0",
   "description": "Claude Code usage tracker and local dashboard for Pro/Max subscription limits - weekly cost-per-percent trend, quota forecasts, threshold alerts. ccusage-compatible.",
   "homepage": "https://github.com/omrikais/cctally",
   "repository": {