feat: make CLI globally installable via npm as @resciencelab/shader-cli

- Rename package to @resciencelab/shader-cli with 'shader-cli' binary
- Use remote runtime (shader-lab.rescience.dev) instead of local dev server
- Move Playwright to optionalDependencies with lazy import
- Add 'shader-cli setup' command for Playwright installation
- Switch build from bun to tsc for Node.js compatibility
- Add shebang, LICENSE, postbuild script
- Update README with npm install instructions

Author: Jing-yilin

README.md

@@ -14,19 +14,18 @@
 <summary>CLI commands used to generate the above</summary>
 
 ```bash
-cd cli
-bun run src/index.ts -- project new -o scene.lab
-bun run src/index.ts -- --project scene.lab layer add crt \
+shader-cli project new -o scene.lab
+shader-cli --project scene.lab layer add crt \
   -p crtMode=composite-tv -p cellSize=4 -p scanlineIntensity=0.3 \
   -p flickerIntensity=0.15 -p glitchIntensity=0.2 -p glitchSpeed=3 \
   -p bloomEnabled=true -p bloomIntensity=1.5 -p barrelDistortion=0.1 \
   -p vignetteIntensity=0.6
-bun run src/index.ts -- --project scene.lab layer add text \
+shader-cli --project scene.lab layer add text \
   -p "text=ReScience Lab" -p fontSize=190 -p fontWeight=800 -p "textColor=#e0e0e0"
-bun run src/index.ts -- --project scene.lab layer add gradient \
+shader-cli --project scene.lab layer add gradient \
   -p preset=sunset -p animate=true -p motionAmount=0.5 -p tonemapMode=cinematic
-bun run src/index.ts -- --project scene.lab timeline duration 6
-bun run src/index.ts -- --project scene.lab export video -o output.webm
+shader-cli --project scene.lab timeline duration 6
+shader-cli --project scene.lab export video -o output.webm
 ```
 </details>
 
@@ -36,23 +35,35 @@ This is a fork of [basement.studio's Shader Lab](https://github.com/basementstud
 
 ## Quick Start
 
+### Install via npm (recommended)
+
 ```bash
-git clone https://github.com/ReScienceLab/shader-cli.git
-cd shader-cli
+# Install globally
+npm i -g @resciencelab/shader-cli
+
+# One-time setup for video export (installs Playwright + Chromium)
+shader-cli setup
+
+# Create a CRT text animation
+shader-cli preset apply crt-text --text "Hello World" -o scene.lab
+shader-cli --project scene.lab export video -o output.webm
+```
 
-# Install editor + CLI dependencies
-bun install
-cd cli && bun install && cd ..
+Or use with `npx` (no install):
 
-# Start the editor (needed for export)
-bun run dev &
+```bash
+npx @resciencelab/shader-cli preset apply crt-text --text "Hello" -o scene.lab
+```
+
+### Install from source
 
-# Create a CRT text animation in one command
-cd cli
-bun run src/index.ts -- preset apply crt-text --text "Hello World" -o scene.lab
-bun run src/index.ts -- --project scene.lab export video -o output.webm
+```bash
+git clone https://github.com/ReScienceLab/shader-cli.git
+cd shader-cli/cli && npm install && npm run build && npm link
 ```
 
+**Runtime:** Export commands use [shader-lab.rescience.dev](https://shader-lab.rescience.dev/tools/shader-lab) by default. Override with `--runtime http://localhost:3000` for local development.
+
 ## CLI Commands
 
 ### Project Management
@@ -93,7 +104,7 @@ shader-cli timeline keyframe add <layer> <time> <property> <value> [-i smooth]
 shader-cli timeline info
 ```
 
-### Export (requires Chrome + WebGPU)
+### Export (requires Playwright + Chrome with WebGPU)
 ```bash
 shader-cli export video [-o out.webm] [--format webm|mp4] [--quality standard] [--fps 30]
 shader-cli export image [-o out.png] [--quality standard] [--time 0]
@@ -106,6 +117,11 @@ shader-cli preset list
 shader-cli preset apply <name> [--text "Text"] [-o out.lab]
 ```
 
+### Setup
+```bash
+shader-cli setup    # Install Playwright + Chromium for video export
+```
+
 ## Built-in Presets
 
 | Preset | Description | Layers |
@@ -127,25 +143,25 @@ shader-cli preset apply <name> [--text "Text"] [-o out.lab]
 
 ### Build from scratch
 ```bash
-bun run src/index.ts -- project new -o my.lab
-bun run src/index.ts -- --project my.lab layer add gradient -p preset=neon-glow -p animate=true
-bun run src/index.ts -- --project my.lab layer add text -p "text=ReScience Lab" -p fontSize=201
-bun run src/index.ts -- --project my.lab layer add dithering -p algorithm=bayer-4x4
-bun run src/index.ts -- --project my.lab layer add crt -p bloomEnabled=true
-bun run src/index.ts -- --project my.lab export video -o output.webm
+shader-cli project new -o my.lab
+shader-cli --project my.lab layer add gradient -p preset=neon-glow -p animate=true
+shader-cli --project my.lab layer add text -p "text=ReScience Lab" -p fontSize=201
+shader-cli --project my.lab layer add dithering -p algorithm=bayer-4x4
+shader-cli --project my.lab layer add crt -p bloomEnabled=true
+shader-cli --project my.lab export video -o output.webm
 ```
 
 ### Agent JSON mode
 ```bash
-bun run src/index.ts -- --json layer types
-bun run src/index.ts -- --json layer params crt
-bun run src/index.ts -- --json --project my.lab layer set 2 -p bloomIntensity=3.0
-bun run src/index.ts -- --json --project my.lab project info
+shader-cli --json layer types
+shader-cli --json layer params crt
+shader-cli --json --project my.lab layer set 2 -p bloomIntensity=3.0
+shader-cli --json --project my.lab project info
 ```
 
 ### REPL mode
 ```bash
-bun run src/index.ts
+shader-cli
 # Enters interactive shell with undo/redo support
 ```
 
@@ -173,9 +189,17 @@ shader-cli/
 
 ## Requirements
 
-- [Bun](https://bun.sh/) >= 1.3
-- Chrome/Chromium with WebGPU support (for export)
-- [Playwright](https://playwright.dev/) (for headless export)
+- [Node.js](https://nodejs.org/) >= 18
+- Chrome/Chromium with WebGPU support (for export — installed automatically via `shader-cli setup`)
+
+## Runtime
+
+Export commands render via a hosted Shader Lab instance at [shader-lab.rescience.dev](https://shader-lab.rescience.dev/tools/shader-lab). No local server needed.
+
+To use a local instance instead:
+```bash
+shader-cli --runtime http://localhost:3000/tools/shader-lab --project scene.lab export video -o out.webm
+```
 
 ## Credits
 

cli/.gitignore

@@ -1 +1,2 @@
 node_modules
+dist

cli/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025-2026 ReScienceLab
+Copyright (c) 2024-2025 basement.studio (original Shader Lab)
+
+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.

cli/package-lock.json

@@ -1,18 +1,45 @@
 {
-  "name": "@shader-lab/cli",
+  "name": "@resciencelab/shader-cli",
   "version": "0.1.0",
-  "description": "CLI harness for Shader Lab — agent-native shader composition",
+  "description": "Agent-native CLI for Shader Lab — compose and export WebGPU shader scenes from the terminal",
   "type": "module",
   "bin": {
-    "shader-lab": "./dist/index.js"
+    "shader-cli": "./dist/index.js"
   },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ReScienceLab/shader-cli.git",
+    "directory": "cli"
+  },
+  "homepage": "https://github.com/ReScienceLab/shader-cli#readme",
+  "license": "MIT",
+  "keywords": [
+    "shader",
+    "webgpu",
+    "cli",
+    "agent",
+    "shader-lab",
+    "video-export",
+    "glsl",
+    "post-processing"
+  ],
   "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target node --format esm",
-    "dev": "bun run src/index.ts",
-    "test": "bun test"
+    "build": "tsc -p tsconfig.json && node scripts/postbuild.js",
+    "prepublishOnly": "npm run build",
+    "dev": "bun run src/index.ts"
   },
   "dependencies": {
-    "commander": "^13.1.0",
+    "commander": "^13.1.0"
+  },
+  "optionalDependencies": {
     "playwright": "^1.52.0"
   },
   "devDependencies": {

cli/package.json

@@ -0,0 +1,9 @@
+import { readFileSync, writeFileSync, chmodSync } from "node:fs"
+
+const entry = new URL("../dist/index.js", import.meta.url).pathname
+const content = readFileSync(entry, "utf-8")
+if (!content.startsWith("#!")) {
+  writeFileSync(entry, `#!/usr/bin/env node\n${content}`)
+}
+chmodSync(entry, 0o755)
+console.log("postbuild: shebang + chmod done")