claude-simple-status 1.3.2 → 1.4.1

package/README.md

@@ -21,8 +21,8 @@ A simple, no-frills statusline for [Claude Code](https://docs.anthropic.com/en/d
 - **Cross-platform** — works on macOS, Linux, and Windows
 - **Non-blocking** — returns cached data instantly, refreshes quota in the background
 - **Color-coded** — green/orange/red percentages at a glance
-- **Context velocity** — estimates remaining turns until context compaction (`42% →~8t`), with directional arrows showing if burn rate is accelerating (↑), steady (→), or decelerating (↓)
-- **Quota pressure** — reset time changes color based on projected burn rate: green (safe), orange (cutting it close), red (will hit the limit before reset). The 7d percentage color is also overridden when the projection says danger
+- **Context velocity** *(opt-in)* — estimates remaining turns until context compaction (`42% →~8t`), with directional arrows showing if burn rate is accelerating (↑), steady (→), or decelerating (↓)
+- **Quota pressure** *(opt-in)* — reset time changes color based on projected burn rate: green (safe), orange (cutting it close), red (will hit the limit before reset). The 7d percentage color is also overridden when the projection says danger
 - **Project name** — bold uppercase project directory name so you never mix up sessions
 - **Git-aware** — shows the current branch name in repos (cached 30s to reduce overhead)
 - **API cost tracking** — pay-as-you-go API users see cumulative session cost instead of quota
@@ -92,6 +92,26 @@ To uninstall, remove `~/.claude/statusline/` and the `"statusLine"` block from s
 
 </details>
 
+## Configuration
+
+Create `~/.config/claude-simple-status.json` to enable optional features:
+
+```json
+{
+  "contextVelocity": true,
+  "quotaBurnRate": true,
+  "refreshInterval": 300
+}
+```
+
+| Option | Default | Description |
+|--------|---------|-------------|
+| `contextVelocity` | `false` | Show estimated turns remaining until context compaction (`42% →~8t`) |
+| `quotaBurnRate` | `false` | Color reset time and 7d quota based on projected burn rate |
+| `refreshInterval` | `300` | Seconds between quota API refreshes (min 60) |
+
+Without this file, you get a clean statusline showing just project, branch, model, context %, reset time, and quota percentages.
+
 ## Requirements
 
 - Claude Code CLI

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "claude-simple-status",
-  "version": "1.3.2",
+  "version": "1.4.1",
   "description": "A simple statusline for Claude Code — project name, git branch, model, context usage, quota, and API costs at a glance",
   "type": "module",
   "bin": {
     "claude-simple-status": "statusline.mjs"
   },
   "scripts": {
+    "test": "node --test statusline.test.mjs",
     "postinstall": "node scripts/setup.mjs install",
     "preuninstall": "node scripts/setup.mjs uninstall"
   },

package/statusline.mjs

@@ -2,10 +2,11 @@
 // Claude Code Statusline - Shows Branch | Model | Context % | Next Reset | 5h Quota % | 7d Quota %
 // Cross-platform Node.js version (no dependencies)
 
-import { readFileSync, writeFileSync, mkdirSync, rmdirSync, statSync, existsSync } from 'fs';
+import { readFileSync, writeFileSync, mkdirSync, rmdirSync, statSync, existsSync, realpathSync, readdirSync, unlinkSync } from 'fs';
 import { homedir, tmpdir } from 'os';
 import { join, basename } from 'path';
 import { spawn, execSync } from 'child_process';
+import { fileURLToPath } from 'url';
 
 // Handle --uninstall flag (workaround: npm doesn't run preuninstall for global packages)
 if (process.argv.includes('--uninstall')) {
@@ -40,9 +41,9 @@ const CREDS_FILE = join(homedir(), '.claude', '.credentials.json');
 const CACHE_FILE = join(tmpdir(), 'claude-statusline-quota.json');
 const LOCK_DIR = join(tmpdir(), 'claude-statusline-quota.lock');
 const ERROR_FILE = join(tmpdir(), 'claude-statusline-error');
+const BACKOFF_FILE = join(tmpdir(), 'claude-statusline-backoff');
 const LOG_FILE = join(tmpdir(), 'claude-statusline.log');
-const CACHE_MAX_AGE = 120; // seconds - when to fetch
-const CACHE_STALE_AGE = 300; // seconds - when to show "--" instead of old values
+let CACHE_STALE_AGE = 300;
 const GIT_BRANCH_CACHE = join(tmpdir(), 'claude-statusline-branches.json');
 const GIT_BRANCH_MAX_AGE = 30; // seconds
 const CONTEXT_HISTORY_FILE = join(tmpdir(), 'claude-statusline-context.json');
@@ -81,6 +82,14 @@ function readJsonFile(filepath) {
     }
 }
 
+// User config — features off by default, opt-in via ~/.config/claude-simple-status.json
+const CONFIG_FILE = join(homedir(), '.config', 'claude-simple-status.json');
+const userConfig = readJsonFile(CONFIG_FILE) || {};
+const SHOW_CONTEXT_VELOCITY = userConfig.contextVelocity === true;
+const SHOW_BURN_RATE = userConfig.quotaBurnRate === true;
+const CACHE_MAX_AGE = Math.max(60, Number(userConfig.refreshInterval) || 300);
+CACHE_STALE_AGE = Math.max(CACHE_STALE_AGE, CACHE_MAX_AGE * 2);
+
 // Clean up stale lock (older than 30s)
 function cleanStaleLock() {
     if (existsSync(LOCK_DIR) && getFileAge(LOCK_DIR) > 30) {
@@ -108,6 +117,7 @@ function refreshInBackground(token) {
         const CACHE_FILE = ${JSON.stringify(CACHE_FILE)};
         const LOCK_DIR = ${JSON.stringify(LOCK_DIR)};
         const ERROR_FILE = ${JSON.stringify(ERROR_FILE)};
+        const BACKOFF_FILE = ${JSON.stringify(BACKOFF_FILE)};
         const LOG_FILE = ${JSON.stringify(LOG_FILE)};
 
         function logError(msg) {
@@ -125,10 +135,10 @@ function refreshInBackground(token) {
             path: '/api/oauth/usage',
             method: 'GET',
             headers: {
-                'Authorization': 'Bearer ${token}',
+                'Authorization': 'Bearer ' + process.env._CLAUDE_SS_TOKEN,
                 'anthropic-beta': 'oauth-2025-04-20',
                 'Accept': 'application/json',
-                'User-Agent': 'claude-code/2.1.12'
+                'User-Agent': 'claude-simple-status/1.5.0'
             },
             timeout: 10000
         }, (res) => {
@@ -140,9 +150,14 @@ function refreshInBackground(token) {
                         JSON.parse(data);
                         writeFileSync(CACHE_FILE, data);
                         try { writeFileSync(ERROR_FILE, ''); } catch {}
+                        try { writeFileSync(BACKOFF_FILE, '{}'); } catch {}
                     } catch { logError('Invalid JSON'); }
+                } else if (res.statusCode === 429) {
+                    const retrySec = parseInt(res.headers['retry-after'], 10) || 300;
+                    const until = Date.now() + retrySec * 1000;
+                    try { writeFileSync(BACKOFF_FILE, JSON.stringify({ until })); } catch {}
+                    logError('HTTP 429 (backoff ' + retrySec + 's)');
                 } else if (res.statusCode !== 401) {
-                    // Skip 401 - token not ready yet at startup, will retry next cycle
                     logError('HTTP ' + res.statusCode);
                 }
                 try { rmdirSync(LOCK_DIR); } catch {}
@@ -154,7 +169,8 @@ function refreshInBackground(token) {
         `
     ], {
         detached: true,
-        stdio: 'ignore'
+        stdio: 'ignore',
+        env: { _CLAUDE_SS_TOKEN: token }
     });
     child.unref();
 }
@@ -345,6 +361,25 @@ async function main() {
         }
     } catch {}
 
+    // Persist session snapshot for external tools (/tmp/claude-sessions/<id>.json)
+    try {
+        const sessionId = JSON.parse(input).session_id;
+        if (sessionId) {
+            const sessDir = join(tmpdir(), 'claude-sessions');
+            mkdirSync(sessDir, { recursive: true });
+            writeFileSync(join(sessDir, `${sessionId}.json`), input);
+            // Clean up stale sessions (not updated in 5 min = dead)
+            for (const f of readdirSync(sessDir)) {
+                if (f.endsWith('.json')) {
+                    try {
+                        const age = Date.now() - statSync(join(sessDir, f)).mtimeMs;
+                        if (age > 5 * 60 * 1000) unlinkSync(join(sessDir, f));
+                    } catch {}
+                }
+            }
+        }
+    } catch {}
+
     // Get OAuth token
     let token = null;
     const creds = readJsonFile(CREDS_FILE);
@@ -360,8 +395,10 @@ async function main() {
         cleanStaleLock();
         const cacheAge = getFileAge(CACHE_FILE);
         const needRefresh = !quotaData || cacheAge >= CACHE_MAX_AGE;
+        const backoffUntil = Number(readJsonFile(BACKOFF_FILE)?.until || 0);
+        const inBackoff = Date.now() < backoffUntil;
 
-        if (needRefresh && acquireLock()) {
+        if (needRefresh && !inBackoff && acquireLock()) {
             refreshInBackground(token);
         }
     }
@@ -400,8 +437,8 @@ async function main() {
         hasError = errContent.length > 0;
     } catch {}
 
-    // Get context velocity estimate
-    const velocity = getContextVelocity(projectDir, contextUsed);
+    // Get context velocity estimate (opt-in)
+    const velocity = SHOW_CONTEXT_VELOCITY ? getContextVelocity(projectDir, contextUsed) : null;
 
     // Get rig name (claude-rig sets CLAUDE_CONFIG_DIR to ~/.claude-rig/rigs/<name>)
     const rigProfile = (() => {
@@ -426,15 +463,15 @@ async function main() {
         contextDisplay += ` ${turnsColor}${velocity.arrow}${turnsStr}${RESET}`;
     }
 
-    // Color the reset time based on 5h quota burn rate projection
-    const fiveHourPressure = getQuotaPressure('5h', fiveHourPct, fiveHourResetsAt);
+    // Color the reset time based on 5h quota burn rate projection (opt-in)
+    const fiveHourPressure = SHOW_BURN_RATE ? getQuotaPressure('5h', fiveHourPct, fiveHourResetsAt) : null;
     let resetDisplay = resetLocal;
     if (fiveHourPressure === 'danger') resetDisplay = `${RED}${resetLocal}${RESET}`;
     else if (fiveHourPressure === 'tight') resetDisplay = `${ORANGE}${resetLocal}${RESET}`;
     else if (fiveHourPressure === 'safe') resetDisplay = `${GREEN}${resetLocal}${RESET}`;
 
-    // Override 7d percentage color when burn rate projects exhaustion before reset
-    const sevenDayPressure = getQuotaPressure('7d', sevenDayPct, sevenDayResetsAt);
+    // Override 7d percentage color when burn rate projects exhaustion before reset (opt-in)
+    const sevenDayPressure = SHOW_BURN_RATE ? getQuotaPressure('7d', sevenDayPct, sevenDayResetsAt) : null;
     let sevenDayDisplay = colorPct(sevenDayPct);
     if (sevenDayPressure === 'danger') sevenDayDisplay = `${RED}${sevenDayPct}%${RESET}`;
     else if (sevenDayPressure === 'tight') sevenDayDisplay = `${ORANGE}${sevenDayPct}%${RESET}`;
@@ -452,4 +489,12 @@ async function main() {
     process.stdout.write(output);
 }
 
-main().catch(() => process.exit(1));
+// Only run when executed directly (not imported for testing)
+const __filename = fileURLToPath(import.meta.url);
+const _isMain = (() => {
+    try { return process.argv[1] && realpathSync(process.argv[1]) === realpathSync(__filename); }
+    catch { return false; }
+})();
+if (_isMain) main().catch(() => process.exit(1));
+
+export { colorPct, getFileAge, readJsonFile, toLocalTime, getContextVelocity, getQuotaPressure, main };