kaizenai 0.5.0 → 0.6.0

package/README.md

@@ -2,7 +2,7 @@
 
 [![npm version](https://img.shields.io/npm/v/kaizenai.svg?style=flat&colorA=18181b&colorB=f472b6)](https://www.npmjs.com/package/kaizenai)
 
-Local first, browser based PDE (Product Development Environment) useClaude Code, Codex, Gemini, and Cursor on any browser. Pair this with Tailscale to have your development machine in any browser in the world.
+Local first, browser based PDE (Product Development Environment) for Claude Code, Codex, Gemini, and Cursor. Run `kaizen --remote` to bind on your Tailscale network, print a QR handoff URL, and jump from your phone or tablet into the same workspace.
 
 ## Quickstart
 
@@ -45,6 +45,8 @@ kaizen --no-open
 
 Default URL: `http://localhost:3210`
 
+`kaizen --remote` keeps local browser access on `localhost`, resolves your stable Tailscale host, and prints a QR code for the mobile handoff page at `/open`.
+
 ## Requirements
 
 - [Bun](https://bun.sh) v1.3.5+

package/bin/kaizen

@@ -1,11 +1,13 @@
 #!/usr/bin/env node
 
 import { existsSync, realpathSync } from "node:fs"
-import { spawn } from "node:child_process"
+import { spawn, spawnSync } from "node:child_process"
 import path from "node:path"
 import process from "node:process"
 import { fileURLToPath } from "node:url"
 
+const CLI_COMMAND = "kaizen"
+
 function failBunMissing() {
   console.error("Kaizen requires Bun 1.3.5+ to run.")
   console.error("Install Bun from https://bun.sh and then retry.")
@@ -14,28 +16,66 @@ function failBunMissing() {
 
 const binPath = realpathSync(fileURLToPath(import.meta.url))
 const packageRoot = path.dirname(path.dirname(binPath))
+const launcherPath = process.argv[1] ? path.resolve(process.argv[1]) : binPath
+
+function hasCommandOnPath(command) {
+  const lookupCommand = process.platform === "win32" ? "where" : "which"
+  const result = spawnSync(lookupCommand, [command], { stdio: "ignore" })
+  return result.status === 0
+}
 
 function resolveEntrypoint(kind) {
-  const builtPath = path.join(packageRoot, "dist", "server", kind === "child" ? "cli.js" : "cli-supervisor.js")
-  const sourcePath = path.join(packageRoot, "src", "server", kind === "child" ? "cli.ts" : "cli-supervisor.ts")
+  const builtPath = path.join(
+    packageRoot,
+    "dist",
+    "server",
+    kind === "child" ? "cli.js" : "cli-supervisor.js"
+  )
+  const sourcePath = path.join(
+    packageRoot,
+    "src",
+    "server",
+    kind === "child" ? "cli.ts" : "cli-supervisor.ts"
+  )
   return existsSync(builtPath) ? builtPath : sourcePath
 }
 
-const entrypoint = process.env.KAIZEN_CLI_MODE === "child"
-  ? resolveEntrypoint("child")
-  : resolveEntrypoint("supervisor")
+function resolveChildProcessSpec() {
+  if (hasCommandOnPath(CLI_COMMAND)) {
+    return {
+      command: CLI_COMMAND,
+      args: [],
+    }
+  }
+
+  return {
+    command: process.execPath,
+    args: [launcherPath],
+  }
+}
+
+const entrypoint =
+  process.env.KAIZEN_CLI_MODE === "child"
+    ? resolveEntrypoint("child")
+    : resolveEntrypoint("supervisor")
+const childProcess = resolveChildProcessSpec()
 
 const child = spawn("bun", [entrypoint, ...process.argv.slice(2)], {
   stdio: "inherit",
   env: {
     ...process.env,
-    KAIZEN_CLI_CHILD_COMMAND: process.execPath,
-    KAIZEN_CLI_CHILD_ARGS: JSON.stringify([binPath]),
+    KAIZEN_CLI_CHILD_COMMAND: childProcess.command,
+    KAIZEN_CLI_CHILD_ARGS: JSON.stringify(childProcess.args),
   },
 })
 
 child.on("error", (error) => {
-  if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+  if (
+    error &&
+    typeof error === "object" &&
+    "code" in error &&
+    error.code === "ENOENT"
+  ) {
     failBunMissing()
     return
   }