ctxline-claude 0.0.7 → 1.0.0

package/README.md

@@ -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.7",
+  "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,7 +28,7 @@
   ],
   "author": "Mithun Wijayasiri",
   "license": "MIT",
-  "homepage": "https://github.com/MithunWijayasiri/ctxline-claude#readme",
+  "homepage": "https://ctxline.js.org",
   "bugs": {
     "url": "https://github.com/MithunWijayasiri/ctxline-claude/issues"
   },

package/statusline.js

@@ -359,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 '';
 
@@ -395,6 +404,7 @@ 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);
@@ -404,6 +414,7 @@ function outputStatus(data, usage) {
     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) {