skill-statusline 2.3.1 → 2.4.0

package/README.md

@@ -1,6 +1,6 @@
 # skill-statusline
 
-Rich, themeable statusline for Claude Code with accurate context tracking, 5 color themes, 3 layout modes, and zero dependencies.
+Rich, themeable statusline for Claude Code with accurate context tracking, 5 color themes, 3 layout modes, and zero dependencies. Uses a fast Node.js renderer on Windows (no Git Bash overhead), pure bash on Unix.
 
 ## Install
 
@@ -124,13 +124,19 @@ Stored in `~/.claude/statusline-config.json`:
 
 ## Architecture
 
-Pure bash at runtime — zero dependencies. Node.js CLI is only for installation.
+Two rendering engines — the installer picks the right one for your platform:
+
+- **Windows**: Node.js renderer (`statusline-node.js`) — single process, no subprocess spawning, ~30-50ms
+- **macOS/Linux**: Bash engine (`core.sh`) — pure bash, zero dependencies, <50ms with caching
+
+Git Bash on Windows has ~50-100ms overhead *per subprocess spawn* (awk, sed, grep, git, date). A bash statusline spawning 10-20 subprocesses = 500-1000ms. The Node.js renderer eliminates this by doing everything in a single process.
 
 ```
 ~/.claude/
-  statusline-command.sh           # Entry point (called by Claude Code)
+  statusline-command.sh           # Bash entry point (macOS/Linux)
+  statusline-node.js              # Node.js renderer (Windows)
   statusline/
-    core.sh                       # Engine: parse JSON, compute fields, render
+    core.sh                       # Bash engine: parse JSON, compute fields, render
     json-parser.sh                # Nested JSON extraction (no jq)
     helpers.sh                    # Utilities + filesystem caching
     themes/{default,nord,...}.sh  # Color palettes
@@ -138,15 +144,13 @@ Pure bash at runtime — zero dependencies. Node.js CLI is only for installation
   statusline-config.json          # User preferences
 ```
 
-Performance: <50ms with caching, <100ms cold. Git and transcript reads are cached with configurable TTL.
-
 Terminal width is auto-detected — layouts gracefully degrade on narrow terminals.
 
 ## Requirements
 
-- Bash (Git Bash on Windows, or any Unix shell)
+- Node.js >=16 (installer + Windows renderer)
 - Git (for GitHub field)
-- Node.js >=16 (for installer only)
+- Bash (macOS/Linux runtime only — not needed on Windows)
 - Works on Windows, macOS, Linux
 
 ## Part of the Thinqmesh Skills Ecosystem

package/bin/cli.js

@@ -9,7 +9,7 @@ const readline = require('readline');
 const args = process.argv.slice(2);
 const command = args[0];
 const subcommand = args[1];
-const VERSION = '2.2.2';
+const VERSION = '2.4.0';
 
 const PKG_DIR = path.resolve(__dirname, '..');
 const HOME = os.homedir();
@@ -271,10 +271,17 @@ function installFiles() {
     copyDir(layoutsSrc, path.join(SL_DIR, 'layouts'));
   }
 
-  // Copy entry point
+  // Copy entry point (bash)
   const slSrc = path.join(PKG_DIR, 'bin', 'statusline.sh');
   fs.copyFileSync(slSrc, SCRIPT_DEST);
 
+  // Copy Node.js renderer (used on Windows for performance)
+  const nodeSrc = path.join(PKG_DIR, 'bin', 'statusline-node.js');
+  const nodeDest = path.join(CLAUDE_DIR, 'statusline-node.js');
+  if (fs.existsSync(nodeSrc)) {
+    fs.copyFileSync(nodeSrc, nodeDest);
+  }
+
   return true;
 }
 
@@ -352,23 +359,30 @@ async function install() {
   writeConfig(config);
   success(`Config: theme=${CYN}${config.theme}${R}, layout=${CYN}${config.layout}${R}`);
 
-  // Update settings.json — use absolute paths on Windows to avoid WSL bash conflict
+  // Update settings.json
   const settings = readSettings();
-  if (!settings.statusLine || settings.statusLine.command === 'bash ~/.claude/statusline-command.sh') {
-    const isWin = process.platform === 'win32';
+  const isWin = process.platform === 'win32';
+  const prevCmd = settings.statusLine?.command || '';
+  const needsUpdate = !settings.statusLine
+    || prevCmd === 'bash ~/.claude/statusline-command.sh'
+    || (isWin && prevCmd.includes('bash.exe'))
+    || (isWin && prevCmd.includes('\\\\'));
+  if (needsUpdate) {
     let cmd;
     if (isWin) {
-      // Windows has WSL bash at C:\Windows\System32\bash.exe which resolves ~ to /root/
-      // Must use Git Bash explicitly with absolute Windows paths
-      const gitBash = 'C:\\\\Program Files\\\\Git\\\\usr\\\\bin\\\\bash.exe';
-      const script = SCRIPT_DEST.replace(/\//g, '\\\\');
-      cmd = `"${gitBash}" "${script}"`;
+      // Windows: use Node.js renderer directly — avoids Git Bash/MSYS2 overhead
+      // (~50-100ms per subprocess spawn in Git Bash vs single Node.js process)
+      const nodeScript = path.join(CLAUDE_DIR, 'statusline-node.js');
+      cmd = `node "${nodeScript.replace(/\\/g, '/')}"`;
     } else {
       cmd = 'bash ~/.claude/statusline-command.sh';
     }
     settings.statusLine = { type: 'command', command: cmd };
     writeSettings(settings);
     success(`${B}statusLine${R} config added to settings.json`);
+    if (isWin) {
+      info(`Using Node.js renderer (fast on Windows)`);
+    }
   } else {
     success(`statusLine already configured in settings.json`);
   }
@@ -408,8 +422,12 @@ async function install() {
   }
 
   blank();
-  bar(`Script:    ${R}${CYN}~/.claude/statusline-command.sh${R}`);
-  bar(`Engine:    ${R}${CYN}~/.claude/statusline/core.sh${R}`);
+  if (isWin) {
+    bar(`Renderer:  ${R}${CYN}~/.claude/statusline-node.js${R} ${D}(Node.js)${R}`);
+  } else {
+    bar(`Script:    ${R}${CYN}~/.claude/statusline-command.sh${R}`);
+    bar(`Engine:    ${R}${CYN}~/.claude/statusline/core.sh${R}`);
+  }
   bar(`Config:    ${R}${CYN}~/.claude/statusline-config.json${R}`);
   bar(`Settings:  ${R}${CYN}~/.claude/settings.json${R}`);
   blank();
@@ -431,13 +449,18 @@ function uninstall() {
     success(`Removed ~/.claude/statusline/`);
   }
 
-  // Remove script
+  // Remove scripts
   if (fs.existsSync(SCRIPT_DEST)) {
     fs.unlinkSync(SCRIPT_DEST);
     success(`Removed ~/.claude/statusline-command.sh`);
   } else {
     warn(`statusline-command.sh not found`);
   }
+  const nodeScript = path.join(CLAUDE_DIR, 'statusline-node.js');
+  if (fs.existsSync(nodeScript)) {
+    fs.unlinkSync(nodeScript);
+    success(`Removed ~/.claude/statusline-node.js`);
+  }
 
   // Remove config
   if (fs.existsSync(CONFIG_PATH)) {
@@ -524,40 +547,53 @@ function preview() {
     agent: { name: 'code-reviewer' }
   });
 
-  // Check if v2 engine is installed
-  const coreFile = path.join(SL_DIR, 'core.sh');
-  let scriptPath;
-  if (fs.existsSync(coreFile)) {
-    scriptPath = coreFile;
-  } else if (fs.existsSync(SCRIPT_DEST)) {
-    scriptPath = SCRIPT_DEST;
+  const isWin = process.platform === 'win32';
+
+  // On Windows, prefer Node.js renderer for speed
+  const nodeRendererInstalled = path.join(CLAUDE_DIR, 'statusline-node.js');
+  const nodeRendererPkg = path.join(PKG_DIR, 'bin', 'statusline-node.js');
+  const nodeRenderer = fs.existsSync(nodeRendererInstalled) ? nodeRendererInstalled : nodeRendererPkg;
+
+  if (isWin || !fs.existsSync(path.join(SL_DIR, 'core.sh'))) {
+    // Use Node.js renderer
+    try {
+      const result = execSync(`node "${nodeRenderer.replace(/\\/g, '/')}"`, {
+        input: sampleJson,
+        encoding: 'utf8',
+        timeout: 5000
+      });
+      log('');
+      log(result);
+      log('');
+    } catch (e) {
+      warn(`Preview failed: ${e.message}`);
+    }
   } else {
-    // Use the package's own script
-    scriptPath = path.join(PKG_DIR, 'lib', 'core.sh');
-  }
+    // Unix: use bash engine with theme/layout overrides
+    const coreFile = path.join(SL_DIR, 'core.sh');
+    const scriptPath = fs.existsSync(coreFile) ? coreFile : SCRIPT_DEST;
 
-  const env = { ...process.env };
-  if (themeName) env.STATUSLINE_THEME_OVERRIDE = themeName;
-  if (layoutName) env.STATUSLINE_LAYOUT_OVERRIDE = layoutName;
+    const env = { ...process.env };
+    if (themeName) env.STATUSLINE_THEME_OVERRIDE = themeName;
+    if (layoutName) env.STATUSLINE_LAYOUT_OVERRIDE = layoutName;
 
-  // For preview with package's own files, set STATUSLINE_DIR
-  if (!fs.existsSync(path.join(SL_DIR, 'core.sh'))) {
-    // Point to package's own lib directory structure
-    env.HOME = PKG_DIR;
-  }
+    if (!fs.existsSync(path.join(SL_DIR, 'core.sh'))) {
+      env.HOME = PKG_DIR;
+    }
 
-  try {
-    const escaped = sampleJson.replace(/'/g, "'\\''");
-    const result = execSync(`printf '%s' '${escaped}' | bash "${scriptPath.replace(/\\/g, '/')}"`, {
-      encoding: 'utf8',
-      env,
-      timeout: 5000
-    });
-    log('');
-    log(result);
-    log('');
-  } catch (e) {
-    warn(`Preview failed: ${e.message}`);
+    try {
+      const escaped = sampleJson.replace(/'/g, "'\\''");
+      const result = execSync(`printf '%s' '${escaped}' | bash "${scriptPath.replace(/\\/g, '/')}"`, {
+        encoding: 'utf8',
+        env,
+        timeout: 5000
+      });
+      log('');
+      log(result);
+      log('');
+    } catch (e) {
+      warn(`Preview failed: ${e.message}`);
+    }
   }
 }
 
@@ -816,23 +852,55 @@ function doctor() {
     warn(`No config file (using defaults)`);
   }
 
-  // 9. Performance benchmark
+  // 9. Node.js renderer
+  const nodeRendererPath = path.join(CLAUDE_DIR, 'statusline-node.js');
+  if (fs.existsSync(nodeRendererPath)) {
+    success(`Node.js renderer installed (statusline-node.js)`);
+  } else if (process.platform === 'win32') {
+    fail(`Node.js renderer missing — required on Windows`);
+    info(`Run ${CYN}ccsl install${R} to fix`);
+    issues++;
+  } else {
+    bar(`Node.js renderer not installed (optional on Unix)`);
+  }
+
+  // 10. Performance benchmark
   blank();
   info(`${B}Performance benchmark${R}`);
   blank();
   try {
     const sampleJson = '{"model":{"id":"claude-opus-4-6","display_name":"Opus"},"workspace":{"current_dir":"/tmp"},"cost":{"total_cost_usd":0.5},"context_window":{"context_window_size":200000,"used_percentage":50,"current_usage":{"input_tokens":90000,"output_tokens":10000,"cache_creation_input_tokens":0,"cache_read_input_tokens":0}}}';
-    const target = fs.existsSync(coreFile) ? coreFile : SCRIPT_DEST;
-    if (target && fs.existsSync(target)) {
+
+    // Benchmark Node.js renderer
+    if (fs.existsSync(nodeRendererPath)) {
       const start = Date.now();
-      execSync(`printf '%s' '${sampleJson}' | bash "${target.replace(/\\/g, '/')}"`, {
+      execSync(`node "${nodeRendererPath.replace(/\\/g, '/')}"`, {
+        input: sampleJson,
         encoding: 'utf8',
         timeout: 10000
       });
       const elapsed = Date.now() - start;
       const color = elapsed < 50 ? GRN : elapsed < 100 ? YLW : RED;
       const label = elapsed < 50 ? 'excellent' : elapsed < 100 ? 'good' : 'slow';
-      log(`  ${GRAY}\u2502${R}  ${color}\u25CF${R} Execution: ${color}${B}${elapsed}ms${R} (${label}, target: <50ms)`);
+      log(`  ${GRAY}\u2502${R}  ${color}\u25CF${R} Node.js renderer: ${color}${B}${elapsed}ms${R} (${label})`);
+    }
+
+    // Benchmark bash engine (skip on Windows — known slow)
+    if (process.platform !== 'win32') {
+      const target = fs.existsSync(coreFile) ? coreFile : SCRIPT_DEST;
+      if (target && fs.existsSync(target)) {
+        const start = Date.now();
+        execSync(`printf '%s' '${sampleJson}' | bash "${target.replace(/\\/g, '/')}"`, {
+          encoding: 'utf8',
+          timeout: 10000
+        });
+        const elapsed = Date.now() - start;
+        const color = elapsed < 50 ? GRN : elapsed < 100 ? YLW : RED;
+        const label = elapsed < 50 ? 'excellent' : elapsed < 100 ? 'good' : 'slow';
+        log(`  ${GRAY}\u2502${R}  ${color}\u25CF${R} Bash engine: ${color}${B}${elapsed}ms${R} (${label})`);
+      }
+    } else {
+      bar(`Bash benchmark skipped (slow on Windows, using Node.js)`);
     }
   } catch (e) {
     fail(`Benchmark failed: ${e.message.substring(0, 50)}`);

package/bin/statusline-node.js

@@ -1,17 +1,27 @@
 #!/usr/bin/env node
-// skill-statusline v2.3 — Node.js statusline renderer
+// skill-statusline v2.4 — Node.js statusline renderer
 // Zero bash dependency — works on Windows, macOS, Linux
-// Synchronous stdin read + transcript tail for live activity
+// Async stdin with hard 1.5s timeout to prevent hangs
 
 'use strict';
 const fs = require('fs');
 const path = require('path');
-try {
-  const input = fs.readFileSync(0, 'utf8');
-  if (input) render(JSON.parse(input));
-} catch (e) { /* silent exit on any error */ }
+
+// Hard kill — prevents hanging if stdin pipe never closes on Windows
+setTimeout(() => process.exit(0), 1500);
+
+let input = '';
+process.stdin.setEncoding('utf8');
+process.stdin.on('data', c => input += c);
+process.stdin.on('end', () => {
+  try { if (input) render(JSON.parse(input)); } catch (e) {}
+  process.exit(0);
+});
+process.stdin.on('error', () => process.exit(0));
+process.stdin.resume();
 
 function getActivity(transcriptPath) {
+  if (!transcriptPath) return 'Idle';
   try {
     const stat = fs.statSync(transcriptPath);
     const readSize = Math.min(16384, stat.size);
@@ -29,7 +39,6 @@ function getActivity(transcriptPath) {
             const last = toolUses[toolUses.length - 1];
             const name = last.name;
             const inp = last.input || {};
-            // Enrich with context for special tools
             if (name === 'Task' && inp.subagent_type) {
               const desc = inp.description ? ': ' + inp.description.slice(0, 25) : '';
               return `Task(${inp.subagent_type}${desc})`;
@@ -50,13 +59,11 @@ function getGitInfo(projectDir) {
     const gitHead = fs.readFileSync(path.join(projectDir, '.git', 'HEAD'), 'utf8').trim();
     branch = gitHead.startsWith('ref: refs/heads/') ? gitHead.slice(16) : gitHead.slice(0, 7);
   } catch (e) { return 'no-git'; }
-  // Parse remote URL from .git/config
   try {
     const config = fs.readFileSync(path.join(projectDir, '.git', 'config'), 'utf8');
     const urlMatch = config.match(/\[remote "origin"\][^[]*url\s*=\s*(.+)/);
     if (urlMatch) {
       const url = urlMatch[1].trim();
-      // Extract owner/repo from various URL formats
       const ghMatch = url.match(/github\.com[:/]([^/]+)\/([^/.]+)/);
       if (ghMatch) remote = ghMatch[1] + '/' + ghMatch[2];
     }
@@ -69,26 +76,21 @@ function render(data) {
   const CYAN = '\x1b[38;2;6;182;212m', PURPLE = '\x1b[38;2;168;85;247m';
   const GREEN = '\x1b[38;2;34;197;94m', YELLOW = '\x1b[38;2;245;158;11m';
   const RED = '\x1b[38;2;239;68;68m', ORANGE = '\x1b[38;2;251;146;60m';
-  const WHITE = '\x1b[38;2;228;228;231m', PINK = '\x1b[38;2;236;72;153m';
+  const WHITE = '\x1b[38;2;228;228;231m';
   const SEP = '\x1b[38;2;55;55;62m', DIM = '\x1b[38;2;40;40;45m';
   const BLUE = '\x1b[38;2;59;130;246m';
 
-  // Model
   const model = data.model?.display_name || 'unknown';
 
-  // Directory — last 3 path segments
   const cwd = (data.workspace?.current_dir || data.cwd || '').replace(/\\/g, '/').replace(/\/\/+/g, '/');
   const parts = cwd.split('/').filter(Boolean);
   const dir = parts.length > 3 ? parts.slice(-3).join('/') : parts.length > 0 ? parts.join('/') : '~';
 
-  // Git — account/repo:branch from .git/HEAD + .git/config
   const projectDir = data.workspace?.project_dir || data.workspace?.current_dir || data.cwd || '';
   const gitInfo = getGitInfo(projectDir);
 
-  // Live activity — tail transcript for current tool/skill/agent/task
   const activity = getActivity(data.transcript_path);
 
-  // Context — use Claude's provided percentage
   let pct = Math.floor(data.context_window?.used_percentage || 0);
   if (pct > 100) pct = 100;
   const ctxClr = pct > 90 ? RED : pct > 75 ? ORANGE : pct > 40 ? YELLOW : WHITE;
@@ -96,11 +98,9 @@ function render(data) {
   const filled = Math.min(Math.floor(pct * barW / 100), barW);
   const bar = ctxClr + '\u2588'.repeat(filled) + RST + DIM + '\u2591'.repeat(barW - filled) + RST;
 
-  // Cost
   const costRaw = data.cost?.total_cost_usd || 0;
   const cost = costRaw === 0 ? '$0.00' : costRaw < 0.01 ? `$${costRaw.toFixed(4)}` : `$${costRaw.toFixed(2)}`;
 
-  // Tokens — session totals (in + out = total)
   const fmtTok = n => n >= 1000000 ? `${(n/1000000).toFixed(1)}M` : n >= 1000 ? `${(n/1000).toFixed(1)}k` : `${n}`;
   const totIn = data.context_window?.total_input_tokens || 0;
   const totOut = data.context_window?.total_output_tokens || 0;
@@ -108,16 +108,13 @@ function render(data) {
   const tokIn = fmtTok(totIn);
   const tokOut = fmtTok(totOut);
 
-  // Session duration
   const durMs = data.cost?.total_duration_ms || 0;
   const durMin = Math.floor(durMs / 60000);
   const durSec = Math.floor((durMs % 60000) / 1000);
   const duration = durMin > 0 ? `${durMin}m ${durSec}s` : `${durSec}s`;
 
-  // Activity color — highlight when active
   const actClr = activity === 'Idle' ? DIM : GREEN;
 
-  // Separator + padding
   const S = `  ${SEP}\u2502${RST}  `;
   const rpad = (s, w) => {
     const plain = s.replace(/\x1b\[[0-9;]*m/g, '');
@@ -125,7 +122,6 @@ function render(data) {
   };
   const C1 = 44;
 
-  // Output 4 rows
   let out = '';
   out += ' ' + rpad(`${actClr}Action:${RST} ${actClr}${activity}${RST}`, C1) + S + `${WHITE}Git:${RST} ${WHITE}${gitInfo}${RST}\n`;
   out += ' ' + rpad(`${PURPLE}Model:${RST} ${PURPLE}${BOLD}${model}${RST}`, C1) + S + `${CYAN}Dir:${RST} ${CYAN}${dir}${RST}\n`;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "skill-statusline",
-  "version": "2.3.1",
-  "description": "Rich, themeable statusline for Claude Code — accurate context tracking, 5 themes, 3 layouts, token/cost/GitHub/skill display. Pure bash, zero deps.",
+  "version": "2.4.0",
+  "description": "Rich, themeable statusline for Claude Code — accurate context tracking, 5 themes, 3 layouts, token/cost/GitHub/skill display. Node.js renderer on Windows (no bash overhead), pure bash on Unix.",
   "bin": {
     "skill-statusline": "bin/cli.js",
     "ccsl": "bin/cli.js"