claude-limit-statusline 0.2.0 → 0.4.0

package/README.md

@@ -1,13 +1,24 @@
 # claude-limit-statusline
 
+[![npm version](https://img.shields.io/npm/v/claude-limit-statusline.svg)](https://www.npmjs.com/package/claude-limit-statusline)
+[![npm downloads](https://img.shields.io/npm/dm/claude-limit-statusline.svg)](https://www.npmjs.com/package/claude-limit-statusline)
+[![license](https://img.shields.io/npm/l/claude-limit-statusline.svg)](./LICENSE)
+[![node](https://img.shields.io/node/v/claude-limit-statusline.svg)](https://nodejs.org)
+
 A [Claude Code](https://code.claude.com/docs) status line that shows your **real
 subscription limits** — the 5‑hour session window and the 7‑day weekly window —
 with a **live reset countdown**.
 
+📦 [npm](https://www.npmjs.com/package/claude-limit-statusline) ·
+🔗 [GitHub](https://github.com/ann0nip/claude-limit-statusline)
+
 ```
-🤖 Opus 4.8 (1M context) | 🧠 42k (4%) | ⏳ Session 17% · resets in 0h47m (23:12) | 📅 Week 10% · resets in 2d 21h (Jun 03 19:54)
+🤖 Opus 4.8 | 🧠 42k (4%) | 🕔 Session 17% · resets in 0h47m | 📅 Week 10%
 ```
 
+That's the default (`medium`). Pick the [size](#sizes) that fits your terminal —
+from `full` (both reset countdowns) down to `bare` (just the two percentages).
+
 Unlike tools that estimate the 5‑hour block from local logs, this reads the
 **official `rate_limits` payload** that Claude Code provides on stdin — the same
 numbers you see when you run `/usage`. No guessing, no rounding to the hour.
@@ -36,10 +47,10 @@ for you (merging, never clobbering your other settings). Then open a **new**
 Claude Code session and send one message — `rate_limits` populates after the
 first API response.
 
-Want only the two limits? Pass your display options straight through:
+Want a different size? Pass your display options straight through:
 
 ```bash
-cc-limits --install --segments=session,week
+cc-limits --install --size=compact
 ```
 
 To remove it again:
@@ -53,6 +64,12 @@ cc-limits --uninstall
 > installed command isn't on the `PATH` of the non‑login shell Claude Code uses
 > for the status line.
 
+> **Upgrading from 0.3.x / 0.2.x?** The old adaptive‑width behavior is gone —
+> replaced by fixed [sizes](#sizes) (default `medium`). Re‑run `cc-limits
+> --install` (optionally with `--size=…`) to refresh the baked‑in command; any
+> leftover `--width` / `--no-adapt` flags are now ignored. The session icon also
+> changed from ⏳ to 🕔.
+
 <details>
 <summary>Manual setup (if you prefer)</summary>
 
@@ -79,15 +96,44 @@ If the bar stays blank (nvm/Volta `PATH` issue), use absolute paths instead —
 | --- | --- | --- |
 | `🤖 model` | Active model | local |
 | `🧠 42k (4%)` | Tokens in the current context window | local |
-| `⏳ Session 17% · resets in 0h47m (23:12)` | **Real** 5‑hour limit used + reset | server |
-| `📅 Week 10% · resets in 2d 21h (Jun 03 19:54)` | **Real** 7‑day limit used + reset | server |
+| `🕔 Session 17% · resets in 0h47m (23:12)` | **Real** 5‑hour limit used (+ reset) | server |
+| `📅 Week 10% · resets in 2d 21h (Jun 03 19:54)` | **Real** 7‑day limit used (+ reset) | server |
 
 The percentage **is** your "how close am I to the limit" gauge. Subscription
 limits are dynamic, so Anthropic does not expose a fixed token cap — only a
 percentage, which is exactly what this surfaces.
 
 Before the first API response (and right after `/compact`) the session segment
-shows `⏳ Session --` until fresh data arrives.
+shows `🕔 Session --` until fresh data arrives.
+
+## Sizes
+
+Claude Code shows the status line on a single line and truncates anything past
+the terminal width. So instead of guessing, you **pick the size that fits** —
+set it once with `--size` (or `CC_LIMITS_SIZE`). The default is `medium`.
+
+```text
+full     🤖 Opus 4.8 (1M context) | 🧠 42k (4%) | 🕔 Session 17% · resets in 0h47m (23:12) | 📅 Week 10% · resets in 2d 21h (Jun 03 19:54)
+medium   🤖 Opus 4.8 | 🧠 42k (4%) | 🕔 Session 17% · resets in 0h47m | 📅 Week 10%
+compact  🤖 Opus 4.8 | 🧠 42k (4%) | 🕔 Session 17% | 📅 Week 10%
+mini     🤖 Opus 4.8 | 🧠 42k | 🕔 S 17% | 📅 W 10%
+bare     🕔 S 17% | 📅 W 10%
+```
+
+| Size | Shows |
+| --- | --- |
+| `full` | Model (with context length), tokens + %, both limits with reset countdown & clock |
+| `medium` | Model, tokens + %, session countdown, both percentages *(default)* |
+| `compact` | Model, tokens + %, both percentages — no countdowns |
+| `mini` | Model, tokens, short labels |
+| `bare` | Just the two limits |
+
+```bash
+cc-limits --install --size=compact
+```
+
+You can still fine‑tune any size with [`--segments`](#flags) and
+[`--reset`](#flags) below.
 
 ## Configuration
 
@@ -102,20 +148,22 @@ Pick **which segments** to show (and their order). The four segments are
 "command": "cc-limits --no-context"
 ```
 
-Pick **which reset countdowns** to show:
+Cap **which reset countdowns** a size may show (this can hide a countdown,
+never add one):
 
 ```jsonc
-"command": "cc-limits --reset=session"   // session reset only
-"command": "cc-limits --no-reset"        // just percentages, no countdowns
+"command": "cc-limits --size=full --reset=session"  // full, but no week countdown
+"command": "cc-limits --no-reset"                   // just percentages, no countdowns
 ```
 
 ### Flags
 
 | Flag | Description |
 | --- | --- |
+| `--size=full\|medium\|compact\|mini\|bare` | How much detail to show (default `medium`) |
 | `--segments=a,b,c` | Allowlist + order. Subset of `model,context,session,week` |
 | `--no-<segment>` | Hide one segment (e.g. `--no-context`). Repeatable |
-| `--reset=both\|session\|week\|none` | Which reset countdowns to show (default `both`) |
+| `--reset=both\|session\|week\|none` | Cap which reset countdowns may show (default `both`) |
 | `--no-reset` | Shorthand for `--reset=none` |
 | `--no-color` | Disable ANSI colors |
 | `--demo` | Print a sample line (no stdin needed) |
@@ -127,6 +175,7 @@ Equivalent to the flags, handy if you don't want to edit the command string:
 
 | Env var | Default | Description |
 | --- | --- | --- |
+| `CC_LIMITS_SIZE` | `medium` | `full` / `medium` / `compact` / `mini` / `bare` |
 | `CC_LIMITS_SEGMENTS` | `model,context,session,week` | Segments + order |
 | `CC_LIMITS_RESET` | `both` | `both` / `session` / `week` / `none` |
 | `CC_LIMITS_WARN` | `70` | % at/above which a limit turns yellow |
@@ -136,7 +185,7 @@ Equivalent to the flags, handy if you don't want to edit the command string:
 
 ```bash
 cc-limits --demo
-cc-limits --segments=session,week --reset=session --demo
+cc-limits --size=compact --demo
 ```
 
 ## How it works

package/bin/cli.js

@@ -57,14 +57,26 @@ if (segSel != null && segSel !== "") {
   SEGMENTS = ALL_SEGMENTS.filter((s) => !argv.includes(`--no-${s}`));
 }
 
-// Which reset countdowns to show: both | session | week | none.
+// Size preset: how much detail to show. The user picks the one that fits their
+// terminal — predictable, no width guessing. Default "medium".
+const SIZES = ["full", "medium", "compact", "mini", "bare"];
+let SIZE = (
+  getFlagValue("--size") ||
+  process.env.CC_LIMITS_SIZE ||
+  "medium"
+).toLowerCase();
+if (!SIZES.includes(SIZE)) SIZE = "medium";
+
+// Which reset countdowns are *allowed*: both | session | week | none. This only
+// caps what a preset would show (it can hide a countdown, never add one).
+// Default both (no extra cap on top of the chosen preset).
 let RESET_MODE = (
   getFlagValue("--reset") ||
   process.env.CC_LIMITS_RESET ||
   "both"
 ).toLowerCase();
 if (argv.includes("--no-reset")) RESET_MODE = "none";
-function showReset(which) {
+function resetAllowed(which) {
   return RESET_MODE === "both" || RESET_MODE === which;
 }
 
@@ -133,65 +145,87 @@ function fmtClock(epochSec, withDate) {
 }
 
 // ---------- segment renderers ----------
-function renderModel(data) {
-  const model = clean(data?.model?.display_name || "Claude");
+// A `v` (variant) describes how compact to be:
+//   v.model  "full" = name as-is | "trim" = drop "(…)" suffix | "off" = hide
+//   v.ctx    "pct"  = "🧠 172k (17%)" | "tokens" = "🧠 172k" | "off" = hide
+//   v.short  true => short limit labels (Session→S, Week→W)
+//   v.rs/v.rw  reset detail for session/week: 2 = "…Xd Yh (clock)", 1 = "…Xd Yh", 0 = none
+function renderModel(data, v) {
+  let model = clean(data?.model?.display_name || "Claude");
+  // Drop trailing parenthetical (e.g. "Opus 4.8 (1M context)" → "Opus 4.8").
+  if (v.model === "trim") model = model.replace(/\s*\([^)]*\)\s*$/, "").trim();
   return paint("🤖 " + model, C.cyan);
 }
-function renderContext(data) {
+function renderContext(data, v) {
   const cw = data?.context_window || {};
   const tokens =
     (Number(cw.total_input_tokens) || 0) +
     (Number(cw.total_output_tokens) || 0);
   let s = "🧠 " + humanTokens(tokens);
-  if (cw.used_percentage != null) s += ` (${round(cw.used_percentage)}%)`;
+  if (v.ctx === "pct" && cw.used_percentage != null) {
+    s += ` (${round(cw.used_percentage)}%)`;
+  }
   return paint(s, C.gray);
 }
-function renderLimit(limit, { icon, label, which, withDate }) {
+function renderLimit(limit, { icon, label, shortLabel, withDate }, { short, reset }) {
+  const lbl = short ? shortLabel : label;
   if (!limit || limit.used_percentage == null) {
-    return paint(`${icon} ${label} --`, C.dim);
+    return paint(`${icon} ${lbl} --`, C.dim);
   }
   const p = round(limit.used_percentage);
-  let s = `${icon} ${label} ${paint(p + "%", pctColor(p))}`;
-  if (limit.resets_at > 0 && showReset(which)) {
-    s += paint(
-      ` · resets in ${fmtCountdown(limit.resets_at)} (${fmtClock(
-        limit.resets_at,
-        withDate
-      )})`,
-      C.dim
-    );
+  let s = `${icon} ${lbl} ${paint(p + "%", pctColor(p))}`;
+  if (limit.resets_at > 0 && reset > 0) {
+    const clock = reset >= 2 ? ` (${fmtClock(limit.resets_at, withDate)})` : "";
+    s += paint(` · resets in ${fmtCountdown(limit.resets_at)}${clock}`, C.dim);
   }
   return s;
 }
 
-function render(data) {
+// Build one status line at a given variant. Reset levels (rs/rw) are also
+// capped by the user's --reset choice (it can hide a countdown, never add one).
+function buildLine(data, v) {
   const rl = data?.rate_limits || {};
+  const cap = (which, level) => (resetAllowed(which) ? level : 0);
   const out = [];
   for (const seg of SEGMENTS) {
-    if (seg === "model") out.push(renderModel(data));
-    else if (seg === "context") out.push(renderContext(data));
-    else if (seg === "session")
+    if (seg === "model") {
+      if (v.model !== "off") out.push(renderModel(data, v));
+    } else if (seg === "context") {
+      if (v.ctx !== "off") out.push(renderContext(data, v));
+    } else if (seg === "session") {
       out.push(
-        renderLimit(rl.five_hour, {
-          icon: "⏳",
-          label: "Session",
-          which: "session",
-          withDate: false,
-        })
+        renderLimit(
+          rl.five_hour,
+          { icon: "🕔", label: "Session", shortLabel: "S", withDate: false },
+          { short: v.short, reset: cap("session", v.rs) }
+        )
       );
-    else if (seg === "week")
+    } else if (seg === "week") {
       out.push(
-        renderLimit(rl.seven_day, {
-          icon: "📅",
-          label: "Week",
-          which: "week",
-          withDate: true,
-        })
+        renderLimit(
+          rl.seven_day,
+          { icon: "📅", label: "Week", shortLabel: "W", withDate: true },
+          { short: v.short, reset: cap("week", v.rw) }
+        )
       );
+    }
   }
   return out.join(SEP);
 }
 
+// Size presets, richest → smallest. The user picks one with --size / CC_LIMITS_SIZE.
+const PRESETS = {
+  full:    { model: "full", ctx: "pct",    short: false, rs: 2, rw: 2 },
+  medium:  { model: "trim", ctx: "pct",    short: false, rs: 1, rw: 0 },
+  compact: { model: "trim", ctx: "pct",    short: false, rs: 0, rw: 0 },
+  mini:    { model: "trim", ctx: "tokens", short: true,  rs: 0, rw: 0 },
+  bare:    { model: "off",  ctx: "off",     short: true,  rs: 0, rw: 0 },
+};
+
+function render(data) {
+  return buildLine(data, PRESETS[SIZE] || PRESETS.medium);
+}
+
 // ---------- demo payload ----------
 function demoPayload() {
   const now = Math.floor(Date.now() / 1000);
@@ -223,25 +257,33 @@ if (argv.includes("--help") || argv.includes("-h")) {
       "real Pro/Max rate limits (5h session + 7d week) with reset countdowns.",
       "",
       "Setup (writes ~/.claude/settings.json for you):",
-      "  cc-limits --install                      configure the status line",
-      "  cc-limits --install --segments=session,week   ...with display options",
-      "  cc-limits --uninstall                    remove it again",
+      "  cc-limits --install                  configure the status line",
+      "  cc-limits --install --size=compact   ...at a chosen size",
+      "  cc-limits --uninstall                remove it again",
       "",
       "Or set it manually in ~/.claude/settings.json:",
       '  "statusLine": { "type": "command", "command": "cc-limits" }',
       "",
+      "Size (pick the one that fits your terminal — default medium):",
+      "  --size=full      🤖 Opus 4.8 (1M context) | 🧠 172k (17%) | 🕔 Session 14% · resets in 2h55m (04:00) | 📅 Week 12% · resets…",
+      "  --size=medium    🤖 Opus 4.8 | 🧠 172k (17%) | 🕔 Session 14% · resets in 2h55m | 📅 Week 12%",
+      "  --size=compact   🤖 Opus 4.8 | 🧠 172k (17%) | 🕔 Session 14% | 📅 Week 12%",
+      "  --size=mini      🤖 Opus 4.8 | 🧠 172k | 🕔 S 14% | 📅 W 12%",
+      "  --size=bare      🕔 S 14% | 📅 W 12%",
+      "",
       "Segments (default: all, in this order): model, context, session, week",
       "  --segments=session,week   Show only these, in this order",
       "  --no-context              Hide a single segment (repeatable)",
       "  --no-model --no-week      ...",
       "",
-      "Reset countdowns:",
-      "  --reset=both|session|week|none   Which resets to show (default both)",
+      "Reset countdowns (a preset's countdowns can be hidden, never added):",
+      "  --reset=both|session|week|none   Which resets MAY show (default both)",
       "  --no-reset                       Same as --reset=none",
       "",
       "Other flags: --demo, --no-color, -h/--help",
       "",
       "Env vars:",
+      "  CC_LIMITS_SIZE=full|medium|compact|mini|bare",
       "  CC_LIMITS_SEGMENTS=model,context,session,week",
       "  CC_LIMITS_RESET=both|session|week|none",
       "  CC_LIMITS_WARN=70    yellow threshold (% of a limit)",
@@ -307,7 +349,10 @@ function doUninstall() {
 }
 
 if (argv.includes("--install")) {
-  const passthrough = argv.filter((a) => a !== "--install" && a !== "--uninstall");
+  // Bake only persistent display flags into the command — never the one-shot
+  // ones (--install/--demo/--help) or the status line would break.
+  const TRANSIENT = new Set(["--install", "--uninstall", "--demo", "--help", "-h"]);
+  const passthrough = argv.filter((a) => !TRANSIENT.has(a));
   doInstall(passthrough);
   process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-limit-statusline",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Claude Code status line that shows your REAL Pro/Max subscription limits — 5-hour session and 7-day weekly usage with a live reset countdown. Uses the official rate_limits payload, not a local estimate.",
   "type": "commonjs",
   "bin": {