ctxline-claude 0.0.6 → 1.0.0

package/README.md

@@ -12,10 +12,10 @@
     <img src="https://img.shields.io/npm/dm/ctxline-claude" alt="npm downloads">
   </a>
   <a href="LICENSE">
-    <img src="https://img.shields.io/github/license/MithunWijayasiri/claudecode-statusline" alt="license">
+    <img src="https://img.shields.io/github/license/MithunWijayasiri/ctxline-claude" alt="license">
   </a>
-  <a href="https://github.com/MithunWijayasiri/claudecode-statusline/stargazers">
-    <img src="https://img.shields.io/github/stars/MithunWijayasiri/claudecode-statusline" alt="stars">
+  <a href="https://github.com/MithunWijayasiri/ctxline-claude/stargazers">
+    <img src="https://img.shields.io/github/stars/MithunWijayasiri/ctxline-claude" alt="stars">
   </a>
 </p>
 
@@ -43,8 +43,8 @@ Then restart Claude Code or start a new session. That's it.
 **Clone & run the installer:**
 
 ```bash
-git clone https://github.com/MithunWijayasiri/claudecode-statusline.git
-cd claudecode-statusline
+git clone https://github.com/MithunWijayasiri/ctxline-claude.git
+cd ctxline-claude
 ./install.sh      # macOS / Linux
 ./install.ps1     # Windows (PowerShell)
 ```
@@ -52,7 +52,7 @@ cd claudecode-statusline
 **Manual:** download the script, then point `~/.claude/settings.json` at it.
 
 ```bash
-curl -o ~/.claude/hooks/statusline.js https://raw.githubusercontent.com/MithunWijayasiri/claudecode-statusline/main/statusline.js
+curl -o ~/.claude/hooks/statusline.js https://raw.githubusercontent.com/MithunWijayasiri/ctxline-claude/main/statusline.js
 chmod +x ~/.claude/hooks/statusline.js
 ```
 
@@ -103,6 +103,7 @@ Remove-Item "$env:USERPROFILE\.claude\cache\usage-cache.json" -ErrorAction Silen
 | **Context** | Visual bar of context-window usage |
 | **Current** | Live 5-hour session limit + reset countdown (subscription users) |
 | **Weekly** | Weekly usage allowance + time until the weekly reset (subscription users) |
+| **Cost** | Running session cost in USD (e.g. `$0.42`) |
 | **Task** | The in-progress todo, when there is one |
 
 > [!NOTE]
@@ -125,6 +126,13 @@ Yes — the same 5-hour and weekly limits. It reads them from the session data C
 
 </details>
 
+<details>
+<summary>Is the session cost my actual bill?</summary>
+
+It's the cost Claude Code computes for the session (tokens × per-model API pricing), read straight from the session data. For subscription (Pro/Max) users it's the *equivalent* pay-as-you-go API cost — useful as a gauge of session weight, but not what you're billed (you pay the flat subscription). It's an estimate, accurate to the extent your Claude Code pricing tables are current.
+
+</details>
+
 <details>
 <summary>Does it work with API keys?</summary>
 
@@ -135,7 +143,7 @@ Yes. The statusline automatically detects subscription vs API-key usage.
 <details>
 <summary>Can it break Claude Code?</summary>
 
-No. All failures are handled silently and the statusline always renders.
+No. [Statuslines are a built-in Claude Code feature](https://code.claude.com/docs/en/statusline) — this provides the command Claude Code runs. All failures are handled silently and the statusline always renders.
 
 </details>
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ctxline-claude",
-  "version": "0.0.6",
+  "version": "1.0.0",
   "description": "A customizable statusline for Claude Code that tracks context usage and session limits",
   "bin": {
     "ctxline-claude": "bin/install.js"
@@ -28,12 +28,12 @@
   ],
   "author": "Mithun Wijayasiri",
   "license": "MIT",
-  "homepage": "https://github.com/MithunWijayasiri/claudecode-statusline#readme",
+  "homepage": "https://ctxline.js.org",
   "bugs": {
-    "url": "https://github.com/MithunWijayasiri/claudecode-statusline/issues"
+    "url": "https://github.com/MithunWijayasiri/ctxline-claude/issues"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/MithunWijayasiri/claudecode-statusline.git"
+    "url": "https://github.com/MithunWijayasiri/ctxline-claude.git"
   }
 }

package/statusline.js

@@ -2,7 +2,7 @@
 // Claude Code Enhanced Statusline
 // Shows: directory | model | context usage | current (5-hour) + weekly usage | current task
 // Auto-detects API key vs subscription usage
-// https://github.com/MithunWijayasiri/claudecode-statusline
+// https://github.com/MithunWijayasiri/ctxline-claude
 
 const fs = require('fs');
 const path = require('path');
@@ -109,23 +109,21 @@ function getContextBar(remaining) {
   const filled = Math.round((used / 100) * BAR_WIDTH);
   const bar = '\u2588'.repeat(filled) + '\u2591'.repeat(BAR_WIDTH - filled);
 
-  let coloredBar;
-  if (used < 50) {
-    coloredBar = `${colors.green}${bar} ${used}%${colors.reset}`;
-  } else if (used < 65) {
-    coloredBar = `${colors.yellow}${bar} ${used}%${colors.reset}`;
-  } else if (used < 80) {
-    coloredBar = `${colors.orange}${bar} ${used}%${colors.reset}`;
-  } else {
-    coloredBar = `${colors.blink}${colors.red}${bar} ${used}%${colors.reset}`;
-  }
+  // Context color: green <50 / yellow <65 / orange <80 / blink-red >=80.
+  let color;
+  if (used < 50) color = colors.green;
+  else if (used < 65) color = colors.yellow;
+  else if (used < 80) color = colors.orange;
+  else color = colors.blink + colors.red;
 
-  return coloredBar;
+  // Compact label form: "C<used> <bar>" (e.g. "C45 ███░░░"), colored as a whole.
+  return `${color}C${used} ${bar}${colors.reset}`;
 }
 
-// Render the usage bar from raw data. Called on every read (live or cached) so the
-// reset countdown is always recomputed from resetsAt rather than frozen at fetch time.
-function buildUsageBar(percentage, resetsAt) {
+// Render a compact usage segment from raw data: "<label><pct> ↺ <countdown>"
+// (e.g. "H81 ↺ 2h21m") — no bar. Called on every read (live or cached) so the reset
+// countdown is always recomputed from resetsAt rather than frozen at fetch time.
+function buildUsageBar(label, percentage, resetsAt) {
   let timeStr = '';
   if (resetsAt) {
     const diffMins = Math.max(0, Math.floor((new Date(resetsAt) - new Date()) / 60000));
@@ -137,21 +135,18 @@ function buildUsageBar(percentage, resetsAt) {
     else timeStr = `${mins}m`;
   }
 
-  const filledWidth = Math.max(0, Math.min(BAR_WIDTH, Math.round((percentage / 100) * BAR_WIDTH)));
-  const filled = '█'.repeat(filledWidth);
-  const empty = '░'.repeat(BAR_WIDTH - filledWidth);
   const color = getUsageColor(percentage);
-  const timePart = timeStr ? `${colors.dim} (${timeStr})${colors.reset}` : '';
+  const timePart = timeStr ? `${colors.dim} ↺ ${timeStr}${colors.reset}` : '';
 
-  return `${color}${filled}${empty} ${percentage}%${colors.reset}${timePart}`;
+  return `${color}${label}${percentage}${colors.reset}${timePart}`;
 }
 
-// Build both usage bars from raw entries. Each entry is { percentage, resetsAt } or
-// null/absent. Returns { current, weekly } where each is a rendered bar string or null.
+// Build both usage segments from raw entries. Each entry is { percentage, resetsAt } or
+// null/absent. Returns { current, weekly } where each is a rendered segment string or null.
 function buildUsageBars(fiveHour, weekly) {
   return {
-    current: fiveHour ? buildUsageBar(fiveHour.percentage, fiveHour.resetsAt) : null,
-    weekly: weekly ? buildUsageBar(weekly.percentage, weekly.resetsAt) : null
+    current: fiveHour ? buildUsageBar('H', fiveHour.percentage, fiveHour.resetsAt) : null,
+    weekly: weekly ? buildUsageBar('W', weekly.percentage, weekly.resetsAt) : null
   };
 }
 
@@ -364,6 +359,15 @@ function getUsageWithCache(callback) {
   });
 }
 
+// Session cost from stdin `cost.total_cost_usd` (USD float, computed client-side by
+// Claude Code as tokens × per-model API pricing). Pure stdin — no network/cache.
+// Returns "$0.00" rendered dim, or '' when absent/non-finite so the segment is omitted.
+function getCostSegment(data) {
+  const usd = data?.cost?.total_cost_usd;
+  if (!Number.isFinite(usd)) return '';
+  return `${colors.dim}$${usd.toFixed(2)}${colors.reset}`;
+}
+
 function getCurrentTask(sessionId) {
   if (!sessionId) return '';
 
@@ -400,15 +404,17 @@ function outputStatus(data, usage) {
     const remaining = data?.context_window?.remaining_percentage;
 
     const contextBar = getContextBar(remaining);
+    const cost = getCostSegment(data);
     const task = getCurrentTask(sessionId);
     const parts = [];
     parts.push(branch ? `${dirname} ${colors.dim}⎇ ${branch}${colors.reset}` : dirname);
     parts.push(effort ? `${model}${getEffortColor(effort)} · ${effort}${colors.reset}` : model);
-    parts.push(`CTX ${contextBar}`);
+    parts.push(contextBar);
 
-    if (usage?.current) parts.push(`5h ${usage.current}`);
-    if (usage?.weekly) parts.push(`7d ${usage.weekly}`);
+    if (usage?.current) parts.push(usage.current);
+    if (usage?.weekly) parts.push(usage.weekly);
 
+    if (cost) parts.push(cost);
     if (task) parts.push(`${colors.dim}${task}${colors.reset}`);
     process.stdout.write(parts.join(' \u2502 '));
   } catch (e) {
@@ -418,9 +424,9 @@ function outputStatus(data, usage) {
 
 function outputFallback(usage) {
   const contextBar = getContextBar(undefined);
-  const parts = ['~', 'Claude', `CTX ${contextBar}`];
-  if (usage?.current) parts.push(`5h ${usage.current}`);
-  if (usage?.weekly) parts.push(`7d ${usage.weekly}`);
+  const parts = ['~', 'Claude', contextBar];
+  if (usage?.current) parts.push(usage.current);
+  if (usage?.weekly) parts.push(usage.weekly);
   process.stdout.write(parts.join(' \u2502 '));
 }