contextbricks-universal 4.2.1 → 4.2.2

package/README.md

@@ -1,5 +1,8 @@
 # ContextBricks Universal
 
+[![npm version](https://img.shields.io/npm/v/contextbricks-universal.svg)](https://www.npmjs.com/package/contextbricks-universal)
+[![license](https://img.shields.io/npm/l/contextbricks-universal.svg)](LICENSE)
+
 > Cross-platform statusline for [Claude Code](https://claude.ai/code) CLI with real-time context brick visualization.
 
 **Works on Windows, Linux, and macOS** — pure Node.js, no bash or jq required.
@@ -15,6 +18,7 @@
 
 - **Real-time context tracking** — brick visualization of context window usage
 - **Rate limit tracking** — 5-hour and 7-day utilization with reset timers (Max/Pro subscribers)
+- **Color gradient** — 256-color green-to-red scale based on utilization percentage
 - **Official percentage fields** (Claude Code 2.1.6+) with fallback calculation (2.0.70+)
 - **Git integration** — repo, branch, commit hash, message, dirty/ahead/behind indicators
 - **Session metrics** — model name, lines changed, duration, cost (hidden for Max subscribers)
@@ -26,22 +30,20 @@
 
 ```bash
 npm install -g contextbricks-universal
-contextbricks install
 ```
 
-Or one-liner via npx (installs and runs automatically):
+The postinstall script runs `contextbricks install` automatically.
+
+### One-liner via npx
 
 ```bash
 npx contextbricks-universal
 ```
 
-Node.js is the only requirement (already present if you use Claude Code).
-
-### From GitHub (without npm)
+### From GitHub
 
 ```bash
 npm install -g github:thebtf/contextbricks-universal
-contextbricks install
 ```
 
 ### From Source
@@ -52,12 +54,21 @@ cd contextbricks-universal
 node bin/cli.js install
 ```
 
+Node.js is the only requirement (already present if you use Claude Code).
+
 ### What the Installer Does
 
 1. Copies `statusline.js` to `~/.claude/statusline.js`
 2. Updates `~/.claude/settings.json` with the `statusLine` command
 3. Backs up existing configuration before any changes
 
+### Updating
+
+```bash
+npm update -g contextbricks-universal
+contextbricks install
+```
+
 ## Display Layout
 
 ### Line 1 — Model + Git + Changes
@@ -149,7 +160,7 @@ Line 4 shows your current utilization of Claude's rate limits — useful for Max
 1. Reads your OAuth token from Claude Code credentials (`~/.claude/.credentials.json`, or macOS keychain)
 2. Fetches usage data from `api.anthropic.com/api/oauth/usage`
 3. Caches the response for 5 minutes (`~/.claude/.usage-cache.json`)
-4. Displays utilization percentages with color coding:
+4. Displays utilization percentages with 256-color gradient:
    - **Green** (0-49%) — plenty of capacity
    - **Yellow** (50-79%) — approaching limit
    - **Red** (80-100%) — near or at limit
@@ -163,7 +174,7 @@ Line 4 shows your current utilization of Claude's rate limits — useful for Max
 
 - Your OAuth token is never logged or exposed in command arguments
 - Token is passed to the HTTPS subprocess via environment variable
-- Cache file (`~/.claude/.usage-cache.json`) is stored locally
+- Cache file (`~/.claude/.usage-cache.json`) is stored locally with restricted permissions (0600)
 
 ### Troubleshooting
 
@@ -186,15 +197,15 @@ contextbricks test
 
 No bash, jq, bc, sed, cut, or any other Unix tools required.
 
-## Bash vs Node.js
+## Comparison with Original
 
-| | Bash (v3.5) | Node.js (v4.x) |
+| | [contextbricks](https://www.npmjs.com/package/contextbricks) (bash) | [contextbricks-universal](https://www.npmjs.com/package/contextbricks-universal) (Node.js) |
 |---|---|---|
 | **Platform** | Linux/macOS only | Windows + Linux + macOS |
 | **Dependencies** | bash, jq, git, bc, sed, cut | Node.js only (git optional) |
 | **JSON parsing** | External `jq` | Native `JSON.parse()` |
+| **Rate limits** | No | Yes (Line 4) |
 | **Install** | Shell scripts | `npm i -g contextbricks-universal` |
-| **Output** | Identical | Identical |
 
 ## Uninstallation
 
@@ -207,6 +218,11 @@ Or manually:
 2. Remove the `statusLine` section from `~/.claude/settings.json`
 3. Restart Claude Code
 
+To remove the global package:
+```bash
+npm uninstall -g contextbricks-universal
+```
+
 ## Acknowledgements
 
 This project is a cross-platform Node.js rewrite of [ContextBricks](https://github.com/jezweb/claude-skills/tree/main/tools/statusline) created by [Jeremy Dawes](https://github.com/jezweb) ([jezweb.com.au](https://jezweb.com.au)). The original bash implementation provided the foundation for the statusline format, brick visualization, and git integration.

package/bin/cli.js

@@ -76,9 +76,8 @@ function install() {
   console.log('');
 
   // Build the command string for settings.json
-  // Use forward slashes for cross-platform compatibility
-  const homedir = os.homedir().replace(/\\/g, '/');
-  const statuslineCommand = `node ${homedir}/.claude/statusline.js`;
+  // Use absolute path to Node.js executable for reliability across environments
+  const statuslineCommand = `${process.execPath} ${INSTALL_PATH}`.replace(/\\/g, '/');
 
   // Update settings.json
   const settingsBackup = backupFile(SETTINGS_FILE);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "contextbricks-universal",
-  "version": "4.2.1",
+  "version": "4.2.2",
   "description": "Universal cross-platform statusline for Claude Code CLI with context brick visualization. Windows, Linux, macOS. No bash or jq required.",
   "keywords": [
     "claude",

package/scripts/statusline.js

@@ -185,7 +185,13 @@ function fetchUsageData(token, input) {
     };
     const req = https.request(options, (res) => {
       let body = '';
-      res.on('data', (chunk) => body += chunk);
+      let totalSize = 0;
+      const MAX_BODY_SIZE = 1024 * 1024;
+      res.on('data', (chunk) => {
+        totalSize += chunk.length;
+        if (totalSize > MAX_BODY_SIZE) { req.destroy(); return; }
+        body += chunk;
+      });
       res.on('end', () => {
         if (res.statusCode === 200) {
           process.stdout.write(body);