@codexhost/cli 0.2.5 → 0.3.0-test.1

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

package/bin/codexhost.js

@@ -2,10 +2,11 @@
 import { spawn } from "node:child_process";
 import { existsSync, realpathSync } from "node:fs";
 import { createRequire } from "node:module";
+import { homedir } from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
 
-const version = "0.2.5";
+const version = "0.3.0-test.1";
 const userArguments = process.argv.slice(2);
 const startupTraceStartedAt = Date.now();
 function startupTrace(stage) {
@@ -167,14 +168,36 @@ const updateEnvironment = {
   CODEXHOST_NPM_LAUNCHER_PATH: fileURLToPath(import.meta.url),
   CODEXHOST_NPM_PACKAGE_ROOT: packageRoot,
 };
+// A managed SSH installation deliberately exports these variables from the
+// remote login profile so stock Codex can enter the remote Host. When this npm
+// command starts the local Desktop on that same machine, replace the remote
+// bootstrap with a local data root. CODEXHOST_CLAUDE_COMMAND is intentionally
+// shared and therefore preserved.
+const remoteSshBootstrapEnvironment = [
+  "CODEX_INSTALL_DIR",
+  "CODEXHOST_DATA_DIR",
+  "CODEXHOST_DEFAULT_AGENT",
+  "CODEXHOST_HOST_NODE_PATH",
+  "CODEXHOST_HOST_RUNTIME_PATH",
+  "CODEXHOST_REMOTE_SSH_MANAGED",
+  "CODEXHOST_STOCK_CODEX_PATH",
+];
+if (updateEnvironment.CODEXHOST_REMOTE_SSH_MANAGED === "1") {
+  for (const name of remoteSshBootstrapEnvironment) delete updateEnvironment[name];
+  updateEnvironment.CODEXHOST_DATA_DIR = path.join(homedir(), ".codexhost");
+}
 
 let launchArguments;
+let remoteArguments = null;
 if (userArguments.length === 0) {
   launchArguments = ["launch"];
 } else if (userArguments[0] === "launch") {
   launchArguments = userArguments;
 } else if (userArguments[0] === "inspect") {
   launchArguments = userArguments;
+} else if (userArguments[0] === "remote") {
+  launchArguments = null;
+  remoteArguments = userArguments.slice(1);
 } else if (userArguments[0] === "--help" || userArguments[0] === "-h") {
   console.log(
     [
@@ -183,6 +206,7 @@ if (userArguments.length === 0) {
       "  codexhost --version",
       "  codexhost inspect",
       "  codexhost launch [launcher options]",
+      "  codexhost remote install|status|uninstall",
       "",
       "This npm package uses the current Node.js runtime and the packaged",
       "Rust launcher/shim. Codex Desktop must already be installed.",
@@ -195,7 +219,7 @@ if (userArguments.length === 0) {
   );
 }
 
-if (launchArguments[0] === "launch") {
+if (launchArguments?.[0] === "launch") {
   const injected = new Set();
   for (let index = 1; index < launchArguments.length; index += 1) {
     const argument = launchArguments[index];
@@ -221,7 +245,35 @@ if (launchArguments[0] === "launch") {
   launchArguments = ["launch", ...extras, ...launchArguments.slice(1)];
 }
 
-if (launchArguments[0] === "launch") {
+if (remoteArguments !== null) {
+  const child = spawn(
+    process.execPath,
+    [
+      hostRuntime,
+      "--codexhost-remote",
+      ...remoteArguments,
+      "--node",
+      process.execPath,
+      "--shim",
+      shim,
+      "--host-runtime",
+      hostRuntime,
+    ],
+    {
+      env: updateEnvironment,
+      stdio: "inherit",
+      windowsHide: true,
+    },
+  );
+  child.on("error", (error) => fail(error.message));
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      process.kill(process.pid, signal);
+      return;
+    }
+    process.exit(code ?? 1);
+  });
+} 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codexhost/cli",
-  "version": "0.2.5",
+  "version": "0.3.0-test.1",
   "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.2.5",
-    "@codexhost/cli-darwin-x64": "0.2.5",
-    "@codexhost/cli-win32-x64": "0.2.5",
-    "@codexhost/cli-win32-arm64": "0.2.5",
-    "@codexhost/cli-linux-x64": "0.2.5"
+    "@codexhost/cli-darwin-arm64": "0.3.0-test.1",
+    "@codexhost/cli-darwin-x64": "0.3.0-test.1",
+    "@codexhost/cli-win32-x64": "0.3.0-test.1",
+    "@codexhost/cli-win32-arm64": "0.3.0-test.1",
+    "@codexhost/cli-linux-x64": "0.3.0-test.1"
   },
   "keywords": [
     "codex",