@codexhost/cli 0.16.1 → 0.17.0

package/README.md

@@ -5,10 +5,10 @@ Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.
 ## Install
 
 ```bash
-npm install -g @codexhost/cli@0.16.1
+npm install -g @codexhost/cli@0.17.0
 ```
 
-npm automatically installs the matching macOS, Windows, or Linux platform package. Node.js 22 or 24 and the official ChatGPT/Codex Desktop are required.
+npm automatically installs the matching macOS, Windows, or Linux platform package. Node.js 22.19.0 or later, except 23.x and the official ChatGPT/Codex Desktop are required.
 
 ## Usage
 

package/bin/codexhost.js

@@ -6,8 +6,28 @@ import { homedir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-const version = "0.16.1";
+const version = "0.17.0";
+const minimumNodeVersion = "22.19.0";
+const excludedNodeRange = {"from":"23.0.0","to":"24.0.0"};
 const userArguments = process.argv.slice(2);
+{
+  const compare = (left, right) => {
+    const a = left.split(".").map(Number);
+    const b = right.split(".").map(Number);
+    return a[0] - b[0] || a[1] - b[1] || a[2] - b[2];
+  };
+  const current = process.versions.node;
+  if (
+    compare(current, minimumNodeVersion) < 0 ||
+    (compare(current, excludedNodeRange.from) >= 0 &&
+      compare(current, excludedNodeRange.to) < 0)
+  ) {
+    console.error(
+      `codexhost: Node.js ${current} is not supported; @codexhost/cli requires Node.js 22.19.0 or later, except 23.x.`,
+    );
+    process.exit(1);
+  }
+}
 const repositoryUrl = "https://github.com/BytePioneer-AI/codex-host";
 const startupTraceStartedAt = Date.now();
 function startupTrace(stage) {
@@ -234,7 +254,9 @@ if (userArguments.length === 0) {
   consoleArguments = userArguments.slice(1);
 } else if (userArguments[0] === "remote") {
   launchArguments = null;
-  remoteArguments = userArguments.slice(1);
+  // The packaged resources are appended after the subcommand; without one, the
+  // first injected option would be read as the subcommand. Show usage instead.
+  remoteArguments = userArguments.length > 1 ? userArguments.slice(1) : ["help"];
 } else if (userArguments[0] === "broker") {
   launchArguments = null;
   brokerArguments = userArguments.slice(1);
@@ -289,7 +311,9 @@ if (launchArguments?.[0] === "launch") {
     }
   }
   const extras = [];
-  if (!injected.has("--node")) extras.push("--node", process.execPath);
+  if (!injected.has("--node") && process.platform !== "darwin") {
+    extras.push("--node", process.execPath);
+  }
   if (!injected.has("--shim")) extras.push("--shim", shim);
   if (!injected.has("--host-runtime")) extras.push("--host-runtime", hostRuntime);
   if (!injected.has("--desktop-controller")) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexhost/cli",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Run Pi and Claude Code as first-class external harnesses inside Codex Desktop.",
   "type": "module",
   "bin": {
@@ -11,15 +11,15 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=22"
+    "node": ">=22.19.0 <23.0.0 || >=24.0.0"
   },
   "optionalDependencies": {
-    "@codexhost/cli-darwin-arm64": "0.16.1",
-    "@codexhost/cli-darwin-x64": "0.16.1",
-    "@codexhost/cli-win32-x64": "0.16.1",
-    "@codexhost/cli-win32-arm64": "0.16.1",
-    "@codexhost/cli-linux-x64": "0.16.1",
-    "@codexhost/cli-linux-arm64": "0.16.1"
+    "@codexhost/cli-darwin-arm64": "0.17.0",
+    "@codexhost/cli-darwin-x64": "0.17.0",
+    "@codexhost/cli-win32-x64": "0.17.0",
+    "@codexhost/cli-win32-arm64": "0.17.0",
+    "@codexhost/cli-linux-x64": "0.17.0",
+    "@codexhost/cli-linux-arm64": "0.17.0"
   },
   "keywords": [
     "codex",