@codexhost/cli 0.12.0 → 0.12.2

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.12.0
+npm install -g @codexhost/cli@0.12.2
 ```
 
 npm automatically installs the matching macOS, Windows, or Linux platform package. Node.js 22 or 24 and the official ChatGPT/Codex Desktop are required.

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.12.0";
+const version = "0.12.2";
 const userArguments = process.argv.slice(2);
 const repositoryUrl = "https://github.com/BytePioneer-AI/codex-host";
 const startupTraceStartedAt = Date.now();
@@ -206,6 +206,7 @@ const updateEnvironment = {
 const remoteSshBootstrapEnvironment = [
   "CODEX_INSTALL_DIR",
   "CODEXHOST_DATA_DIR",
+  // Retired; older remote profile blocks still export it.
   "CODEXHOST_DEFAULT_AGENT",
   "CODEXHOST_HOST_NODE_PATH",
   "CODEXHOST_HOST_RUNTIME_PATH",
@@ -228,7 +229,7 @@ if (userArguments.length === 0) {
   launchArguments = userArguments;
 } else if (userArguments[0] === "inspect") {
   launchArguments = userArguments;
-} else if (userArguments[0] === "console") {
+} else if (userArguments[0] === "console" || userArguments[0] === "update") {
   launchArguments = null;
   consoleArguments = userArguments.slice(1);
 } else if (userArguments[0] === "remote") {
@@ -252,6 +253,7 @@ if (userArguments.length === 0) {
       "  codexhost --version",
       "  codexhost inspect",
       "  codexhost console",
+      "  codexhost update",
       "  codexhost launch [launcher options]",
       "  codexhost remote install|start|stop|status|uninstall",
       "  codexhost broker install|status|stop|uninstall",
@@ -298,9 +300,9 @@ if (launchArguments?.[0] === "launch") {
 }
 
 if (consoleArguments !== null) {
-  if (consoleArguments.length > 0) fail("console accepts no arguments");
+  if (consoleArguments.length > 0) fail(userArguments[0] + " accepts no arguments");
   if (!existsSync(consoleServer)) fail(`missing console: ${consoleServer}`);
-  const child = spawn(process.execPath, [consoleServer, "open"], {
+  const child = spawn(process.execPath, [consoleServer, userArguments[0] === "update" ? "update" : "open"], {
     env: { ...updateEnvironment, CODEXHOST_LAUNCHER_EXECUTABLE: launcher },
     stdio: "inherit",
     windowsHide: true,
@@ -351,26 +353,50 @@ if (consoleArguments !== null) {
     process.exit(code ?? 1);
   });
 } else if (remoteArguments !== null) {
+  // Every Harness whose plugin selects a BrokeredHarnessAdapter for a managed
+  // macOS remote Host needs its own Aqua LaunchAgent. Keep this list in sync with
+  // those plugin factories; Claude Code keeps the legacy unlabelled invocation.
+  // Install only registers them: the remote Host starts a broker on demand for an
+  // installed Harness and the broker exits when idle.
+  const nativeBrokerHarnessIds = ["claude-code", "codebuddy", "workbuddy", "cursor-cli"];
   const runNativeBroker = (command) => {
-    const broker = spawn(
-      launcher,
-      ["broker", command, "--node", process.execPath, "--host-runtime", hostRuntime],
-      {
-        env: updateEnvironment,
-        // remote status is a stable JSON stdout surface. Keep the broker's
-        // human-readable status beside it on stderr instead of corrupting JSON.
-        stdio: command === "status" ? ["inherit", process.stderr, "inherit"] : "inherit",
-        windowsHide: true,
-      },
-    );
-    broker.on("error", (error) => fail(error.message));
-    broker.on("exit", (code, signal) => {
-      if (signal) {
-        process.kill(process.pid, signal);
+    let index = 0;
+    let firstFailure = 0;
+    // Run every broker even after a failure so one broken service cannot leave
+    // the others stale or installed, then report the first failure.
+    const next = () => {
+      if (index >= nativeBrokerHarnessIds.length) {
+        process.exit(firstFailure);
         return;
       }
-      process.exit(code ?? 1);
-    });
+      const harnessId = nativeBrokerHarnessIds[index++];
+      const broker = spawn(
+        launcher,
+        [
+          "broker",
+          command,
+          ...(harnessId === "claude-code" ? [] : ["--harness", harnessId]),
+          "--node", process.execPath, "--host-runtime", hostRuntime,
+        ],
+        {
+          env: updateEnvironment,
+          // remote status is a stable JSON stdout surface. Keep the broker's
+          // human-readable status beside it on stderr instead of corrupting JSON.
+          stdio: command === "status" ? ["inherit", process.stderr, "inherit"] : "inherit",
+          windowsHide: true,
+        },
+      );
+      broker.on("error", (error) => fail(error.message));
+      broker.on("exit", (code, signal) => {
+        if (signal) {
+          process.kill(process.pid, signal);
+          return;
+        }
+        if (code !== 0 && firstFailure === 0) firstFailure = code ?? 1;
+        next();
+      });
+    };
+    next();
   };
   const child = spawn(
     process.execPath,
@@ -410,6 +436,11 @@ if (consoleArguments !== null) {
         runNativeBroker("uninstall");
         return;
       }
+      if (remoteArguments[0] === "stop") {
+        // Brokers stay registered for on-demand starts by the next remote Host.
+        runNativeBroker("stop");
+        return;
+      }
     }
     process.exit(code ?? 1);
   });

package/package.json

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