claude-limitline 1.4.0 → 1.5.1

package/README.md

@@ -173,12 +173,16 @@ claude-limitline retrieves data from two sources:
 
 ### OAuth Token Location
 
+The tool automatically retrieves your OAuth token from Claude Code's credential storage:
+
 | Platform | Location |
 |----------|----------|
+| **macOS** | Keychain (`Claude Code-credentials` service) |
 | **Windows** | Credential Manager or `~/.claude/.credentials.json` |
-| **macOS** | Keychain or `~/.claude/.credentials.json` |
 | **Linux** | secret-tool (GNOME Keyring) or `~/.claude/.credentials.json` |
 
+> **Note:** On macOS, the token is read directly from the system Keychain where Claude Code stores it. No additional configuration is needed—just make sure you're logged into Claude Code (`claude --login`).
+
 ## Development
 
 ```bash
@@ -191,7 +195,7 @@ npm run dev      # Watch mode
 
 ## Testing
 
-The project uses [Vitest](https://vitest.dev/) for testing with 164 tests covering config loading, themes, segments, utilities, and rendering.
+The project uses [Vitest](https://vitest.dev/) for testing with 170 tests covering config loading, themes, segments, utilities, and rendering.
 
 ```bash
 npm test              # Run tests once
@@ -207,7 +211,7 @@ npm run test:coverage # Coverage report
 | `src/themes/index.test.ts` | 37 | Theme retrieval, color validation |
 | `src/segments/block.test.ts` | 8 | Block segment, time calculations |
 | `src/segments/weekly.test.ts` | 13 | Weekly segment, week progress |
-| `src/utils/oauth.test.ts` | 13 | API responses, caching, trends |
+| `src/utils/oauth.test.ts` | 19 | API responses, caching, trends, macOS keychain |
 | `src/utils/claude-hook.test.ts` | 21 | Model name formatting |
 | `src/utils/environment.test.ts` | 20 | Git branch, directory detection |
 | `src/utils/terminal.test.ts` | 13 | Terminal width, ANSI handling |

package/dist/index.js

@@ -44,6 +44,9 @@ var DEFAULT_CONFIG = {
     showWeekProgress: true,
     viewMode: "simple"
   },
+  context: {
+    enabled: true
+  },
   budget: {
     pollInterval: 15,
     warningThreshold: 80
@@ -161,12 +164,26 @@ async function getOAuthTokenWindows() {
 async function getOAuthTokenMacOS() {
   try {
     const { stdout } = await execAsync(
-      `security find-generic-password -s "Claude Code" -w`,
+      `security find-generic-password -s "Claude Code-credentials" -w`,
       { timeout: 5e3 }
     );
-    const token = stdout.trim();
-    if (token && token.startsWith("sk-ant-oat")) {
-      return token;
+    const content = stdout.trim();
+    if (content.startsWith("{")) {
+      try {
+        const parsed = JSON.parse(content);
+        if (parsed.claudeAiOauth && typeof parsed.claudeAiOauth === "object") {
+          const token = parsed.claudeAiOauth.accessToken;
+          if (token && typeof token === "string" && token.startsWith("sk-ant-oat")) {
+            debug("Found OAuth token in macOS Keychain under claudeAiOauth.accessToken");
+            return token;
+          }
+        }
+      } catch (parseError) {
+        debug("Failed to parse keychain JSON:", parseError);
+      }
+    }
+    if (content.startsWith("sk-ant-oat")) {
+      return content;
     }
   } catch (error) {
     debug("macOS Keychain retrieval failed:", error);
@@ -535,6 +552,8 @@ var darkTheme = {
   // Purple for Opus
   sonnet: { bg: "#1a1a1a", fg: "#89ddff" },
   // Light blue for Sonnet
+  context: { bg: "#2a2a2a", fg: "#87ceeb" },
+  // Sky blue for context
   warning: { bg: "#d75f00", fg: "#ffffff" },
   critical: { bg: "#af0000", fg: "#ffffff" }
 };
@@ -548,6 +567,8 @@ var lightTheme = {
   // Purple for Opus
   sonnet: { bg: "#0ea5e9", fg: "#ffffff" },
   // Sky blue for Sonnet
+  context: { bg: "#6366f1", fg: "#ffffff" },
+  // Indigo for context
   warning: { bg: "#f59e0b", fg: "#000000" },
   critical: { bg: "#ef4444", fg: "#ffffff" }
 };
@@ -561,6 +582,8 @@ var nordTheme = {
   // Nord purple for Opus
   sonnet: { bg: "#2e3440", fg: "#88c0d0" },
   // Nord frost for Sonnet
+  context: { bg: "#3b4252", fg: "#81a1c1" },
+  // Nord frost for context
   warning: { bg: "#d08770", fg: "#2e3440" },
   critical: { bg: "#bf616a", fg: "#eceff4" }
 };
@@ -574,6 +597,8 @@ var gruvboxTheme = {
   // Gruvbox purple for Opus
   sonnet: { bg: "#282828", fg: "#8ec07c" },
   // Gruvbox aqua for Sonnet
+  context: { bg: "#3c3836", fg: "#83a598" },
+  // Gruvbox blue for context
   warning: { bg: "#d79921", fg: "#282828" },
   critical: { bg: "#cc241d", fg: "#ebdbb2" }
 };
@@ -587,6 +612,8 @@ var tokyoNightTheme = {
   // Tokyo purple for Opus
   sonnet: { bg: "#1a202c", fg: "#7dcfff" },
   // Tokyo cyan for Sonnet
+  context: { bg: "#2d3748", fg: "#7aa2f7" },
+  // Tokyo blue for context
   warning: { bg: "#e0af68", fg: "#1a1b26" },
   critical: { bg: "#f7768e", fg: "#1a1b26" }
 };
@@ -600,6 +627,8 @@ var rosePineTheme = {
   // Rose Pine iris for Opus
   sonnet: { bg: "#232136", fg: "#31748f" },
   // Rose Pine pine for Sonnet
+  context: { bg: "#2a273f", fg: "#9ccfd8" },
+  // Rose Pine foam for context
   warning: { bg: "#f6c177", fg: "#191724" },
   critical: { bg: "#eb6f92", fg: "#191724" }
 };
@@ -639,9 +668,12 @@ var Renderer = class {
       sonnet: symbolSet.sonnet_cost,
       bottleneck: symbolSet.bottleneck,
       rightArrow: symbolSet.right,
+      leftArrow: symbolSet.left,
       separator: symbolSet.separator,
       branch: symbolSet.branch,
       model: symbolSet.model,
+      context: "\u25D0",
+      // Half-filled circle for context
       progressFull: symbolSet.progress_full,
       progressEmpty: symbolSet.progress_empty,
       trendUp: "\u2191",
@@ -704,6 +736,18 @@ var Renderer = class {
     output += RESET_CODE;
     return output;
   }
+  renderRightPowerline(segments) {
+    if (segments.length === 0) return "";
+    let output = "";
+    for (let i = 0; i < segments.length; i++) {
+      const seg = segments[i];
+      output += RESET_CODE;
+      output += ansi.fg(seg.colors.bg) + this.symbols.leftArrow;
+      output += ansi.bg(seg.colors.bg) + ansi.fg(seg.colors.fg) + seg.text;
+    }
+    output += RESET_CODE;
+    return output;
+  }
   renderFallback(segments) {
     return segments.map((seg) => ansi.bg(seg.colors.bg) + ansi.fg(seg.colors.fg) + seg.text + RESET_CODE).join(` ${this.symbols.separator} `);
   }
@@ -857,6 +901,18 @@ var Renderer = class {
         return this.renderWeeklySimple(ctx);
     }
   }
+  renderContext(ctx) {
+    if (!this.config.context?.enabled) {
+      return null;
+    }
+    const percent = ctx.envInfo.contextPercent;
+    const icon = this.usePowerline ? this.symbols.context : "CTX";
+    const colors = this.getColorsForPercent(percent, this.theme.context);
+    return {
+      text: ` ${icon} ${percent}% `,
+      colors
+    };
+  }
   getSegment(name, ctx) {
     switch (name) {
       case "directory":
@@ -869,6 +925,8 @@ var Renderer = class {
         return this.renderBlock(ctx);
       case "weekly":
         return this.renderWeekly(ctx);
+      case "context":
+        return this.renderContext(ctx);
       default:
         return null;
     }
@@ -882,22 +940,35 @@ var Renderer = class {
       trendInfo,
       compact
     };
-    const segments = [];
+    const leftSegments = [];
     const order = this.config.segmentOrder ?? ["directory", "git", "model", "block", "weekly"];
     for (const name of order) {
+      if (name === "context") continue;
       const segment = this.getSegment(name, ctx);
       if (segment) {
-        segments.push(segment);
+        leftSegments.push(segment);
       }
     }
-    if (segments.length === 0) {
-      return "";
+    const rightSegments = [];
+    const contextSegment = this.renderContext(ctx);
+    if (contextSegment) {
+      rightSegments.push(contextSegment);
     }
+    let output = "";
     if (this.usePowerline) {
-      return this.renderPowerline(segments);
+      if (leftSegments.length > 0) {
+        output += this.renderPowerline(leftSegments);
+      }
+      if (rightSegments.length > 0) {
+        output += this.renderRightPowerline(rightSegments);
+      }
     } else {
-      return this.renderFallback(segments);
+      const allSegments = [...leftSegments, ...rightSegments];
+      if (allSegments.length > 0) {
+        output = this.renderFallback(allSegments);
+      }
     }
+    return output;
   }
 };
 
@@ -1023,12 +1094,22 @@ function getClaudeModel(hookData) {
   }
   return null;
 }
+function getContextPercent(hookData) {
+  const ctx = hookData?.context_window;
+  if (!ctx?.current_usage || !ctx.context_window_size) {
+    return 0;
+  }
+  const usage = ctx.current_usage;
+  const totalTokens = (usage.input_tokens || 0) + (usage.cache_creation_input_tokens || 0) + (usage.cache_read_input_tokens || 0);
+  return Math.round(totalTokens / ctx.context_window_size * 100);
+}
 function getEnvironmentInfo(hookData) {
   return {
     directory: getDirectoryName(hookData),
     gitBranch: getGitBranch(),
     gitDirty: hasGitChanges(),
-    model: getClaudeModel(hookData)
+    model: getClaudeModel(hookData),
+    contextPercent: getContextPercent(hookData)
   };
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-limitline",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "A statusline for Claude Code showing real-time usage limits and weekly tracking",
   "main": "dist/index.js",
   "bin": {