howmuchleft 0.2.0 → 0.2.1

package/README.md

@@ -3,103 +3,32 @@
 [![npm version](https://img.shields.io/npm/v/howmuchleft)](https://www.npmjs.com/package/howmuchleft)
 [![npm downloads](https://img.shields.io/npm/dm/howmuchleft)](https://www.npmjs.com/package/howmuchleft)
 [![license](https://img.shields.io/npm/l/howmuchleft)](https://github.com/smm-h/howmuchleft/blob/main/LICENSE)
-[![node](https://img.shields.io/node/v/howmuchleft)](https://nodejs.org)
 
-Pixel-perfect progress bars for your Claude Code statusline. See how much context and usage you have left at a glance.
+**Know exactly how much context and usage you have left, right in your Claude Code statusline.**
 
-| Dark | Light |
-|---|---|
-| ![Dark mode demo](./assets/demo-dark.gif) | ![Light mode demo](./assets/demo-light.gif) |
+![Dark mode demo](./assets/demo-dark.gif)
 
-## What you get
+![Light mode demo](./assets/demo-light.gif)
 
-Three bars with sub-cell precision using Unicode fractional block characters:
+Three progress bars with sub-cell precision that shift from green to red as you approach your limits:
 
-| Bar | Shows | Extra info |
-|---|---|---|
-| Context window | How full your conversation is | Subscription tier, model name |
-| 5-hour usage | Rolling rate limit utilization | Time until reset, git branch/changes, lines added/removed |
-| Weekly usage | Rolling 7-day rate limit utilization | Time until reset, current directory |
+| Bar | What it tracks |
+|---|---|
+| **Context window** | How full your conversation is, plus subscription tier and model |
+| **5-hour usage** | Rolling rate limit, time until reset, git branch and diff stats |
+| **Weekly usage** | Rolling 7-day rate limit, time until reset, current directory |
 
-Bars shift green to red as usage increases. Stale data (API unreachable) is prefixed with `~`. Works with Pro, Max 5x, Max 20x, and Team subscriptions. API key users see an "API" label with context bar only.
+Works with Pro, Max 5x, Max 20x, and Team subscriptions. API key users see context bar only.
 
 ## Install
 
+Two commands and you're done:
+
 ```bash
 npm install -g howmuchleft
 howmuchleft --install
 ```
 
-For multiple Claude Code config directories:
-
-```bash
-howmuchleft --install ~/.claude-work
-howmuchleft --install ~/.claude-personal
-```
-
-## Configuration
-
-Config file: `~/.config/howmuchleft.json` (JSONC -- comments and trailing commas are allowed).
-
-```jsonc
-{
-  "progressLength": 12,
-  "colorMode": "auto",
-  "colors": [
-    // Truecolor dark: RGB gradient + RGB background
-    { "dark-mode": true, "true-color": true, "bg": [48, 48, 48], "gradient": [[0,215,0], [255,255,0], [255,0,0]] },
-    // 256-color dark: index gradient + index background
-    { "dark-mode": true, "true-color": false, "bg": 236, "gradient": [46, 226, 196] }
-  ]
-}
-```
-
-### Top-level settings
-
-| Field | Default | Description |
-|---|---|---|
-| `progressLength` | `12` | Bar width in characters (3--40) |
-| `colorMode` | `"auto"` | `"auto"` (detect via `COLORTERM`), `"truecolor"`, or `"256"` |
-| `colors` | built-in | Array of color entries (see below) |
-
-### Color entries
-
-Each entry in the `colors` array is matched against the current terminal. First match wins. Omit a condition to match both modes.
-
-| Field | Required | Description |
-|---|---|---|
-| `gradient` | Yes | Color stops: `[R,G,B]` arrays for truecolor, or integers (0--255) for 256-color |
-| `bg` | No | Empty bar background: `[R,G,B]` for truecolor, or integer (0--255) for 256-color |
-| `dark-mode` | No | Match dark (`true`) or light (`false`) terminals only |
-| `true-color` | No | Match truecolor (`true`) or 256-color (`false`) terminals only |
-
-Truecolor gradients are smoothly interpolated between stops -- 3 stops (green, yellow, red) is enough for a smooth bar. 256-color gradients snap to the nearest stop.
-
-To preview your current gradient: `howmuchleft --test-colors`
-
-## CLI
-
-```
-howmuchleft [config-dir]              Run the statusline (called by Claude Code)
-howmuchleft --install [config-dir]    Add to Claude Code settings.json
-howmuchleft --uninstall [config-dir]  Remove from Claude Code settings.json
-howmuchleft --config                  Show config path and current settings
-howmuchleft --demo [seconds]          Time-lapse animation (default 60s)
-howmuchleft --test-colors             Preview gradient at seven sample levels
-howmuchleft --version                 Show version
-howmuchleft --help                    Show help
-```
-
-## How it works
-
-Claude Code invokes `howmuchleft` as a child process on each statusline render, piping a JSON object to stdin with model info, context window usage, cwd, and cost data. The script:
-
-1. Parses the JSON from stdin
-2. Fetches usage data from Anthropic's OAuth API (cached 60s, stale-data fallback on failure)
-3. Auto-refreshes expired OAuth tokens
-4. Runs `git status --porcelain=v2` in parallel for branch/change info
-5. Renders three lines of ANSI-colored progress bars to stdout
-
 ## Uninstall
 
 ```bash
@@ -107,9 +36,12 @@ howmuchleft --uninstall
 npm uninstall -g howmuchleft
 ```
 
-## Requirements
+## Customize
+
+Config lives at `~/.config/howmuchleft.json` (JSONC -- comments allowed). See [`config.example.json`](./config.example.json) for all options.
+
+- **`progressLength`** -- bar width in characters (default 12)
+- **`colorMode`** -- `"auto"`, `"truecolor"`, or `"256"`
+- **`colors`** -- custom gradient stops and background colors per theme/color-depth combo
 
-- Node.js >= 18
-- Claude Code with OAuth login (Pro, Max, or Team subscription)
-- `git` (optional, for branch/change display)
-- `gsettings` (Linux/GNOME) or `defaults` (macOS) for dark/light mode detection
+Preview your current gradient: `howmuchleft --test-colors`

package/lib/statusline.js

@@ -16,6 +16,7 @@
 
 const fs = require('fs');
 const path = require('path');
+const crypto = require('crypto');
 const https = require('https');
 const { execFile, execFileSync } = require('child_process');
 const { promisify } = require('util');
@@ -238,12 +239,57 @@ function getClaudeDir() {
   return resolvePath(arg);
 }
 
+/**
+ * Read credentials from the macOS Keychain.
+ * Claude Code stores OAuth tokens in the Keychain on macOS instead of
+ * (or in addition to) the .credentials.json file. The service name includes
+ * a hash of the config dir path to support multiple accounts.
+ */
+function readKeychainCredentials(claudeDir) {
+  if (process.platform !== 'darwin') return null;
+  const hash = crypto.createHash('sha256').update(claudeDir).digest('hex').slice(0, 8);
+  // Try current hashed service name, then legacy unhashed name
+  for (const svc of [`Claude Code-credentials-${hash}`, 'Claude Code-credentials']) {
+    try {
+      const raw = execFileSync('security', [
+        'find-generic-password', '-s', svc, '-w',
+      ], { encoding: 'utf8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe'] });
+      const parsed = JSON.parse(raw.trim());
+      if (parsed?.claudeAiOauth?.accessToken) return parsed;
+    } catch {}
+  }
+  return null;
+}
+
+// Cached per-process: credentials won't change during a single render cycle.
+let _credentialsRead = false;
+let _credentialsCache = null;
+
 function readCredentialsFile(claudeDir) {
+  if (_credentialsRead) return _credentialsCache;
+  _credentialsRead = true;
+
+  // Try file first (fast, no system prompt)
+  let fileData = null;
   try {
-    return JSON.parse(fs.readFileSync(path.join(claudeDir, '.credentials.json'), 'utf8'));
-  } catch {
-    return null;
+    fileData = JSON.parse(fs.readFileSync(path.join(claudeDir, '.credentials.json'), 'utf8'));
+  } catch {}
+  if (fileData?.claudeAiOauth?.accessToken) {
+    _credentialsCache = fileData;
+    return fileData;
   }
+
+  // macOS: try Keychain when file lacks OAuth credentials
+  const keychainData = readKeychainCredentials(claudeDir);
+  if (keychainData) {
+    // Merge: preserve file data (mcpOAuth etc.) with keychain OAuth
+    const merged = { ...(fileData || {}), claudeAiOauth: keychainData.claudeAiOauth };
+    _credentialsCache = merged;
+    return merged;
+  }
+
+  _credentialsCache = fileData;
+  return fileData;
 }
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "howmuchleft",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Pixel-perfect progress bars showing how much context and usage you have left, right in your Claude Code statusline",
   "bin": {
     "howmuchleft": "bin/cli.js"