@alyibrahim/claude-statusline 1.0.0 → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 AlyIbrahim1
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,13 +1,13 @@
-# @alyibrahim/claude-statusline
+# claude-statusline
 
-A zero-dependency statusline for [Claude Code](https://claude.ai/code). Shows model, git branch, context usage, subscription rate limits, and session cost — updating after every response.
+[![CI](https://github.com/AlyIbrahim1/claude-statusline/actions/workflows/ci.yml/badge.svg)](https://github.com/AlyIbrahim1/claude-statusline/actions/workflows/ci.yml)
+[![npm](https://img.shields.io/npm/v/@alyibrahim/claude-statusline)](https://www.npmjs.com/package/@alyibrahim/claude-statusline)
 
-## Requirements
+A fast statusline for [Claude Code](https://claude.ai/code). Shows model, git branch, context usage, subscription rate limits, and session cost — updating after every response.
 
-- **Node.js >=16** — the only hard requirement (installed with npm)
-- **git** — optional, used for branch display; gracefully absent if not installed
+Runs as a compiled Rust binary on Linux x64/arm64, macOS x64/arm64, and Windows x64 — no Node.js startup overhead on every prompt. Falls back to Node.js automatically on unsupported platforms.
 
-No `jq`, `bc`, `ccusage`, or other external tools needed.
+![statusline screenshot](.github/image.png)
 
 ## Install
 
@@ -22,6 +22,13 @@ That's it. The statusline is configured automatically. Restart Claude Code to se
 claude-statusline setup
 ```
 
+## Requirements
+
+- **Node.js >=16** — needed for install/uninstall lifecycle scripts
+- **git** — optional, used for branch display; gracefully absent if not installed
+
+No `jq`, `bc`, `ccusage`, or other external tools needed.
+
 ## What it shows
 
 **Line 1:** Model · Effort level · Active agents · Current task · Directory `[git branch]` · Context bar
@@ -32,7 +39,8 @@ claude-statusline setup
 
 | | This package | Others |
 |---|---|---|
-| Zero dependencies | ✓ no `jq`, `bc`, etc. | Require external tools |
+| Fast startup | ✓ compiled Rust binary | Node.js cold-start every prompt |
+| No dependencies | ✓ no `jq`, `bc`, etc. | Require external tools |
 | No API calls | ✓ reads stdin directly | Poll OAuth endpoint, hit rate limits |
 | Subscription vs API aware | ✓ | Show cost for everyone |
 | Context bar normalized | ✓ usable % | Raw remaining % |
@@ -41,14 +49,15 @@ claude-statusline setup
 ## Uninstall
 
 ```bash
+claude-statusline uninstall
 npm uninstall -g @alyibrahim/claude-statusline
 ```
 
-> If using yarn/pnpm/bun, run `claude-statusline uninstall` **before** removing the package.
+> Run `claude-statusline uninstall` first regardless of package manager — this removes the statusline from `~/.claude/settings.json` before the package files are deleted.
 
 ## Notes
 
-- **Switched Node versions?** Re-run `claude-statusline setup` — the Node path is baked in at install time.
+- **Switched Node versions?** Re-run `claude-statusline setup` — only needed if the Rust binary wasn't installed (unsupported platform fallback).
 - Writes only the `statusLine` key in `~/.claude/settings.json` — all other settings are preserved.
 - Respects `$CLAUDE_CONFIG_DIR` if set.
 

package/package.json

@@ -1,16 +1,32 @@
 {
   "name": "@alyibrahim/claude-statusline",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "A zero-dependency Claude Code statusline — reads rate limits from stdin, no API calls",
-  "engines": { "node": ">=16" },
-  "bin": { "claude-statusline": "bin/cli.js" },
+  "engines": {
+    "node": ">=16"
+  },
+  "bin": {
+    "claude-statusline": "bin/cli.js"
+  },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
     "preuninstall": "node scripts/preuninstall.js",
     "test": "jest"
   },
-  "files": ["statusline.js", "bin/", "scripts/", "README.md"],
+  "files": [
+    "statusline.js",
+    "bin/",
+    "scripts/",
+    "README.md"
+  ],
   "license": "MIT",
+  "optionalDependencies": {
+    "@alyibrahim/claude-statusline-linux-x64": "1.1.0",
+    "@alyibrahim/claude-statusline-linux-arm64": "1.1.0",
+    "@alyibrahim/claude-statusline-darwin-x64": "1.1.0",
+    "@alyibrahim/claude-statusline-darwin-arm64": "1.1.0",
+    "@alyibrahim/claude-statusline-win32-x64": "1.1.0"
+  },
   "devDependencies": {
     "jest": "^29.0.0"
   }

package/scripts/config.js

@@ -23,4 +23,21 @@ function atomicWrite(filePath, obj) {
   }
 }
 
-module.exports = { getSettingsPath, atomicWrite };
+/**
+ * Resolves the path to the platform-specific binary, or returns null if not found.
+ * @returns {string|null}
+ */
+function resolveBinary() {
+  const platformKey = `${process.platform}-${process.arch}`;
+  const pkgName = `@alyibrahim/claude-statusline-${platformKey}`;
+  const binName = process.platform === 'win32' ? 'statusline.exe' : 'statusline';
+  let binaryPath = null;
+  try {
+    const pkgJson = require.resolve(`${pkgName}/package.json`);
+    const candidate = path.join(path.dirname(pkgJson), binName);
+    if (fs.existsSync(candidate)) binaryPath = candidate;
+  } catch (e) {}
+  return binaryPath;
+}
+
+module.exports = { getSettingsPath, atomicWrite, resolveBinary };

package/scripts/postinstall.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 'use strict';
+const fs = require('fs');
 const { setup } = require('./setup');
+const config = require('./config');
 try {
   const result = setup({ force: false });
   if (result.settingsPath === null) process.exit(0); // non-global install, skip silently
@@ -10,6 +12,12 @@ try {
   } else {
     console.log('\n✓  claude-statusline configured. Restart Claude Code to see it.\n');
   }
+  const binaryPath = config.resolveBinary();
+  if (binaryPath && process.platform !== 'win32') {
+    try {
+      fs.chmodSync(binaryPath, 0o755);
+    } catch (e) {}
+  }
 } catch (e) {
   // Fully silent on any error — postinstall must never fail npm install
 }

package/scripts/setup.js

@@ -1,7 +1,8 @@
 'use strict';
 const fs = require('fs');
 const path = require('path');
-const { getSettingsPath, atomicWrite } = require('./config');
+const config = require('./config');
+const { getSettingsPath, atomicWrite } = config;
 
 const UNSAFE_CHARS = /["`$!()\\]/;
 
@@ -30,7 +31,11 @@ function setup({ force = false } = {}) {
     }
   }
 
-  const command = `"${process.execPath}" "${scriptPath}"`;
+  const binaryPath = config.resolveBinary();
+  const safeBinary = binaryPath && !UNSAFE_CHARS.test(binaryPath) ? binaryPath : null;
+  const command = safeBinary
+    ? `"${safeBinary}"`
+    : `"${process.execPath}" "${scriptPath}"`;
   settings.statusLine = { type: 'command', command };
 
   fs.mkdirSync(path.dirname(settingsPath), { recursive: true });