@codexhost/cli 0.3.3 → 0.3.4

package/README.md

@@ -5,7 +5,7 @@ Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.
 ## Install
 
 ```bash
-npm install -g @codexhost/cli@0.3.3
+npm install -g @codexhost/cli@0.3.4
 ```
 
 npm automatically installs the matching macOS, Windows, or Linux platform package. Node.js 22 or 24 and the official ChatGPT/Codex Desktop are required.
@@ -17,6 +17,6 @@ codexhost --version
 codexhost
 ```
 
-The `codexhost` command starts Codex Desktop and returns immediately: the packaged Launcher keeps supervising in the background and exits after you quit the Desktop. Re-running `codexhost` attaches to the same controlled instance.
+The `codexhost` command starts Codex Desktop. On macOS and Linux it returns immediately while the packaged Launcher keeps supervising in the background. On Windows, the command remains attached until Codex Desktop exits so shells that clean up process trees of completed commands cannot discard the supervisor. Re-running `codexhost` attaches to the same controlled instance.
 
 If installation used `--omit=optional`, reinstall without that option so npm can select the native package for the current architecture.

package/bin/codexhost.js

@@ -6,7 +6,7 @@ import { homedir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-const version = "0.3.3";
+const version = "0.3.4";
 const userArguments = process.argv.slice(2);
 const startupTraceStartedAt = Date.now();
 function startupTrace(stage) {
@@ -275,9 +275,12 @@ if (remoteArguments !== null) {
   });
 } else if (launchArguments?.[0] === "launch") {
   // The Launcher prints "ready" once the Desktop, Controller, and Host chain
-  // are up, then detaches from the terminal to keep supervising. Return
-  // success immediately so the terminal is not held open by this command.
+  // are up, then detaches from the terminal to keep supervising. Windows
+  // command hosts may clean up a completed command's process tree, so keep the
+  // npm parent alive there until the managed Desktop exits. Other platforms
+  // return immediately after startup as before.
   startupTrace("spawning Launcher");
+  const keepLauncherForeground = process.platform === "win32";
   const child = spawn(launcher, launchArguments, {
     env: updateEnvironment,
     stdio: ["ignore", "pipe", "inherit"],
@@ -291,20 +294,28 @@ if (remoteArguments !== null) {
     process.exit(code);
   };
   child.stdout.setEncoding("utf8");
+  let ready = false;
   let launcherOutput = "";
+  const readyMarker = "ready\n";
   child.stdout.on("data", (chunk) => {
-    launcherOutput += chunk;
-    if (launcherOutput.includes("ready\n")) {
+    if (ready) return;
+    const output = launcherOutput + chunk;
+    if (output.includes(readyMarker)) {
+      ready = true;
+      launcherOutput = "";
       startupTrace("received Launcher ready");
-      finish(0);
+      if (!keepLauncherForeground) finish(0);
+      return;
     }
+    // Only retain the tail needed to recognize a marker split across chunks.
+    launcherOutput = output.slice(1 - readyMarker.length);
   });
   child.on("error", (error) => {
     startupTrace("Launcher spawn failed: " + error.message);
     fail(error.message);
   });
   child.on("exit", (code, signal) => {
-    startupTrace("Launcher exited before ready");
+    startupTrace(ready ? "Launcher exited after ready" : "Launcher exited before ready");
     if (signal) {
       process.kill(process.pid, signal);
       return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexhost/cli",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.",
   "type": "module",
   "bin": {
@@ -14,11 +14,11 @@
     "node": ">=22"
   },
   "optionalDependencies": {
-    "@codexhost/cli-darwin-arm64": "0.3.3",
-    "@codexhost/cli-darwin-x64": "0.3.3",
-    "@codexhost/cli-win32-x64": "0.3.3",
-    "@codexhost/cli-win32-arm64": "0.3.3",
-    "@codexhost/cli-linux-x64": "0.3.3"
+    "@codexhost/cli-darwin-arm64": "0.3.4",
+    "@codexhost/cli-darwin-x64": "0.3.4",
+    "@codexhost/cli-win32-x64": "0.3.4",
+    "@codexhost/cli-win32-arm64": "0.3.4",
+    "@codexhost/cli-linux-x64": "0.3.4"
   },
   "keywords": [
     "codex",