claude-simple-status 1.0.1 → 1.1.0

package/README.md

@@ -19,7 +19,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
-- **Git-aware** — shows the current branch name in repos
+- **Stale-aware** — shows `--` for quota values when cache is outdated, real values appear after first refresh
+- **Git-aware** — shows the current branch name in repos (cached 30s to reduce overhead)
 - **Timezone-smart** — quota reset time converted to your local timezone
 
 If the quota API is unreachable, a red `ERR` indicator appears at the end and clears automatically once the connection recovers.
@@ -32,9 +33,10 @@ npm install -g claude-simple-status
 
 That's it — Claude Code is configured automatically. The statusline appears immediately.
 
-To uninstall (also cleans up the Claude Code config):
+To uninstall:
 
 ```bash
+claude-simple-status --uninstall
 npm uninstall -g claude-simple-status
 ```
 
@@ -101,6 +103,11 @@ Quota data is cached to the system temp directory and refreshed every 2 minutes.
 
 ## Troubleshooting
 
+**Indicators:**
+- `--` for quota values means the cache is stale (>5 minutes old) — values appear after the first background refresh
+- `?` means quota data has never been fetched yet
+- `ERR` (red) means the last quota fetch failed — clears automatically on recovery
+
 If the statusline shows `ERR`, check the error log:
 
 ```bash
@@ -121,6 +128,18 @@ rm /tmp/claude-statusline-quota.json
 Remove-Item $env:TEMP\claude-statusline-quota.json
 ```
 
+## Related projects
+
+### [claude-rig](https://github.com/edimuj/claude-rig)
+
+Run multiple isolated Claude Code configurations simultaneously — each with its own plugins, skills, MCP servers, and settings. When a session is launched through claude-rig, the active profile name appears in the statusline in bold magenta as the first segment:
+
+```
+minimal | main | Opus 4.6 | 12% | 14:30 | 5h:34% | 7d:12%
+```
+
+No configuration needed — claude-simple-status detects claude-rig automatically. Users not using claude-rig are unaffected.
+
 ## Contributing
 
 Contributions are welcome! This project follows a few principles:

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "claude-simple-status",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A simple statusline for Claude Code — git branch, model, context usage, and quota at a glance",
   "type": "module",
   "bin": {
-    "claude-simple-status": "./statusline.mjs"
+    "claude-simple-status": "statusline.mjs"
   },
   "scripts": {
     "postinstall": "node scripts/setup.mjs install",

package/statusline.mjs

@@ -2,17 +2,35 @@
 // 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, appendFileSync } from 'fs';
+import { readFileSync, writeFileSync, mkdirSync, rmdirSync, statSync, existsSync } from 'fs';
 import { homedir, tmpdir } from 'os';
 import { join } from 'path';
 import { spawn, execSync } from 'child_process';
-import { request } from 'https';
+
+// Handle --uninstall flag (workaround: npm doesn't run preuninstall for global packages)
+if (process.argv.includes('--uninstall')) {
+    const settingsFile = join(homedir(), '.claude', 'settings.json');
+    try {
+        const settings = JSON.parse(readFileSync(settingsFile, 'utf8'));
+        if (settings.statusLine?.command === 'claude-simple-status') {
+            delete settings.statusLine;
+            writeFileSync(settingsFile, JSON.stringify(settings, null, 2) + '\n');
+            console.log('claude-simple-status removed from Claude Code settings.');
+        } else {
+            console.log('Nothing to remove (statusLine not managed by claude-simple-status).');
+        }
+    } catch {
+        console.log('Nothing to remove (~/.claude/settings.json not found).');
+    }
+    process.exit(0);
+}
 
 // ANSI color codes
 const GREEN = '\x1b[0;32m';
 const ORANGE = '\x1b[0;33m';
 const RED = '\x1b[0;31m';
 const CYAN = '\x1b[0;36m';
+const MAGENTA_BOLD = '\x1b[1;35m';
 const YELLOW_BOLD = '\x1b[1;33m';
 const RESET = '\x1b[0m';
 
@@ -22,7 +40,10 @@ 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 LOG_FILE = join(tmpdir(), 'claude-statusline.log');
-const CACHE_MAX_AGE = 120; // seconds
+const CACHE_MAX_AGE = 120; // seconds - when to fetch
+const CACHE_STALE_AGE = 300; // seconds - when to show "--" instead of old values
+const GIT_BRANCH_CACHE = join(tmpdir(), 'claude-statusline-branches.json');
+const GIT_BRANCH_MAX_AGE = 30; // seconds
 
 // Color a percentage value based on thresholds
 function colorPct(val) {
@@ -71,30 +92,6 @@ function acquireLock() {
     }
 }
 
-// Release lock
-function releaseLock() {
-    try { rmdirSync(LOCK_DIR); } catch {}
-}
-
-// Log error with timestamp
-function logError(msg) {
-    const ts = new Date().toISOString().replace('T', ' ').slice(0, 19);
-    try {
-        appendFileSync(LOG_FILE, `[${ts}] ${msg}\n`);
-        writeFileSync(ERROR_FILE, msg);
-        // Trim log to last 50 lines
-        const lines = readFileSync(LOG_FILE, 'utf8').split('\n').filter(Boolean);
-        if (lines.length > 50) {
-            writeFileSync(LOG_FILE, lines.slice(-50).join('\n') + '\n');
-        }
-    } catch {}
-}
-
-// Clear error state
-function clearError() {
-    try { writeFileSync(ERROR_FILE, ''); } catch {}
-}
-
 // Spawn background refresh process
 function refreshInBackground(token) {
     const child = spawn(process.execPath, [
@@ -169,13 +166,22 @@ function toLocalTime(isoString) {
     }
 }
 
-// Get current git branch name
+// Get current git branch name (cached per cwd, 30s TTL)
 function getGitBranch() {
+    const cwd = process.cwd();
     try {
-        return execSync('git rev-parse --abbrev-ref HEAD', {
+        const cache = readJsonFile(GIT_BRANCH_CACHE) || {};
+        const entry = cache[cwd];
+        if (entry && (Date.now() - entry.ts) < GIT_BRANCH_MAX_AGE * 1000) {
+            return entry.branch;
+        }
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', {
             timeout: 1000,
             stdio: ['ignore', 'pipe', 'ignore']
         }).toString().trim();
+        cache[cwd] = { branch, ts: Date.now() };
+        try { writeFileSync(GIT_BRANCH_CACHE, JSON.stringify(cache)); } catch {}
+        return branch;
     } catch {
         return null;
     }
@@ -219,12 +225,17 @@ async function main() {
         }
     }
 
-    // Parse quota data
+    // Parse quota data (show "--" if cache is too stale)
     let fiveHourPct = '?';
     let sevenDayPct = '?';
     let resetLocal = '--:--';
+    const cacheIsStale = !quotaData || getFileAge(CACHE_FILE) > CACHE_STALE_AGE;
 
-    if (quotaData) {
+    if (cacheIsStale) {
+        fiveHourPct = '--';
+        sevenDayPct = '--';
+        resetLocal = '--:--';
+    } else if (quotaData) {
         if (quotaData.five_hour === null || quotaData.seven_day === null) {
             // Organization/team plan without individual quota
             fiveHourPct = 'N/A';
@@ -244,11 +255,19 @@ async function main() {
         hasError = errContent.length > 0;
     } catch {}
 
+    // Get rig profile (claude-rig sets CLAUDE_CONFIG_DIR to ~/.claude-rig/profiles/<name>)
+    const rigProfile = (() => {
+        const configDir = process.env.CLAUDE_CONFIG_DIR;
+        if (!configDir) return null;
+        const match = configDir.match(/\.claude-rig\/profiles\/([^/]+)\/?$/);
+        return match ? match[1] : null;
+    })();
+
     // Get git branch
     const branch = getGitBranch();
 
     // Build output
-    let output = `${branch ? `${YELLOW_BOLD}${branch}${RESET} | ` : ''}${CYAN}${model}${RESET} | ${colorPct(contextUsed)}`;
+    let output = `${rigProfile ? `${MAGENTA_BOLD}${rigProfile}${RESET} | ` : ''}${branch ? `${YELLOW_BOLD}${branch}${RESET} | ` : ''}${CYAN}${model}${RESET} | ${colorPct(contextUsed)}`;
     if (token) {
         output += ` | ${resetLocal} | 5h:${colorPct(fiveHourPct)} | 7d:${colorPct(sevenDayPct)}`;
         if (hasError) {