@alyibrahim/claude-statusline 1.0.0 → 1.1.1

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,17 @@
-# @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)
+[![npm downloads](https://img.shields.io/npm/dm/@alyibrahim/claude-statusline)](https://www.npmjs.com/package/@alyibrahim/claude-statusline)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 
-## Requirements
+**A rich, fast statusline for [Claude Code](https://claude.ai/code)** — shows model, git branch, context usage, rate limits, and session cost after every response.
+
+Runs as a **compiled Rust binary** (~5ms startup vs ~100ms for Node.js). Zero shell dependencies. One install command.
 
-- **Node.js >=16** — the only hard requirement (installed with npm)
-- **git** — optional, used for branch display; gracefully absent if not installed
+![statusline screenshot](https://raw.githubusercontent.com/AlyIbrahim1/claude-statusline/main/.github/image.png)
 
-No `jq`, `bc`, `ccusage`, or other external tools needed.
+---
 
 ## Install
 
@@ -15,42 +19,81 @@ No `jq`, `bc`, `ccusage`, or other external tools needed.
 npm install -g @alyibrahim/claude-statusline
 ```
 
-That's it. The statusline is configured automatically. Restart Claude Code to see it.
+Done. The statusline configures itself automatically. Restart Claude Code to see it.
 
-**Manual setup** (if auto-setup failed):
-```bash
-claude-statusline setup
-```
+> If auto-setup didn't run: `claude-statusline setup`
+
+---
+
+## What you get
+
+**Line 1** — Model name · Effort level · Active subagents · Current task · Directory `[branch]` · Context bar
+
+**Line 2** — Weekly token usage · 5h usage · Reset countdown *(Pro/Max)* — or — Session cost *(API key)*
+
+| Feature | Details |
+|---|---|
+| Context bar | Normalized to usable % — accounts for the auto-compact buffer |
+| Rate limits | Shows 5h and weekly usage with color-coded thresholds |
+| Session cost | Displayed only for API key users, hidden for subscribers |
+| Active agents | Counts running subagents from your `~/.claude/todos/` directory |
+| Effort level | Reads `CLAUDE_CODE_EFFORT_LEVEL` env var or `settings.json` |
+| Git branch | Detected automatically, silently absent if not a git repo |
 
-## What it shows
+---
 
-**Line 1:** Model · Effort level · Active agents · Current task · Directory `[git branch]` · Context bar
+## Platform support
 
-**Line 2:** Weekly usage · 5h usage · Reset countdown *(subscription)*  or  Session cost *(API key)*
+The Rust binary is pre-built and installed automatically for your platform via npm `optionalDependencies`:
+
+| Platform | Package |
+|---|---|
+| Linux x64 | [`@alyibrahim/claude-statusline-linux-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-linux-x64) |
+| Linux arm64 | [`@alyibrahim/claude-statusline-linux-arm64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-linux-arm64) |
+| macOS x64 (Intel) | [`@alyibrahim/claude-statusline-darwin-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-darwin-x64) |
+| macOS arm64 (Apple Silicon) | [`@alyibrahim/claude-statusline-darwin-arm64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-darwin-arm64) |
+| Windows x64 | [`@alyibrahim/claude-statusline-win32-x64`](https://www.npmjs.com/package/@alyibrahim/claude-statusline-win32-x64) |
+
+npm picks the right one automatically. If your platform isn't listed, the JS fallback is used instead — no action needed.
+
+---
 
 ## Why this one
 
-| | This package | Others |
+| | claude-statusline | Others |
 |---|---|---|
-| Zero 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 % |
-| Active agent counter | ✓ | — |
+| Startup time | ~5ms (Rust binary) | ~100ms (Node.js cold-start every prompt) |
+| Shell dependencies | None | Require `jq`, `bc`, or `ccusage` |
+| API calls | None — reads Claude's stdin directly | Poll OAuth endpoint, risk rate limits |
+| Subscription-aware | Shows usage/resets for Pro/Max, cost for API | Treat everyone as API user |
+| Context bar | Usable % after auto-compact buffer | Raw remaining % |
+| Subagent counter | Counts active agents from todos dir | — |
+
+---
+
+## Requirements
+
+- **Node.js ≥16** — for install/uninstall scripts only (not needed at runtime on supported platforms)
+- **git** — optional, enables branch display
+
+---
 
 ## Uninstall
 
 ```bash
+claude-statusline uninstall
 npm uninstall -g @alyibrahim/claude-statusline
 ```
 
-> If using yarn/pnpm/bun, run `claude-statusline uninstall` **before** removing the package.
+> Always run `claude-statusline uninstall` first — it removes the `statusLine` entry from `~/.claude/settings.json` before the files are deleted.
+
+---
 
 ## Notes
 
-- **Switched Node versions?** Re-run `claude-statusline setup` — the Node path is baked in at install time.
-- Writes only the `statusLine` key in `~/.claude/settings.json` — all other settings are preserved.
-- Respects `$CLAUDE_CONFIG_DIR` if set.
+- Settings are written only to the `statusLine` key — all other `~/.claude/settings.json` keys are untouched
+- Respects `$CLAUDE_CONFIG_DIR` if set
+- Switched Node versions on an unsupported platform? Re-run `claude-statusline setup`
 
 ## License
 

package/package.json

@@ -1,16 +1,32 @@
 {
   "name": "@alyibrahim/claude-statusline",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "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 });