@codexhost/cli 0.10.2 → 0.12.0

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.10.2
+npm install -g @codexhost/cli@0.12.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.

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.10.2";
+const version = "0.12.0";
 const userArguments = process.argv.slice(2);
 const repositoryUrl = "https://github.com/BytePioneer-AI/codex-host";
 const startupTraceStartedAt = Date.now();
@@ -104,21 +104,16 @@ const shim = path.join(packageRoot, "libexec", `codexhost-shim${executableSuffix
 const hostRuntime = path.join(packageRoot, "app", "host-runtime.mjs");
 const desktopController = path.join(packageRoot, "app", "desktop-controller.mjs");
 const rendererExtension = path.join(packageRoot, "app", "renderer-extension.js");
+const consoleServer = path.join(packageRoot, "app", "console-server.mjs");
 
 function fail(message) {
   console.error(`codexhost: ${message}`);
   process.exit(1);
 }
 
-for (const [label, filePath] of [
-  ["launcher", launcher],
-  ["shim", shim],
-  ["host runtime", hostRuntime],
-  ["desktop controller", desktopController],
-  ["renderer extension", rendererExtension],
-]) {
-  if (!existsSync(filePath)) fail(`missing ${label}: ${filePath}`);
-}
+// Desktop resources are validated by the Launcher after it starts the recovery
+// console. Do not prevent recovery when one of those resources is missing.
+if (!existsSync(launcher)) fail(`missing launcher: ${launcher}`);
 
 function existingFile(filePath) {
   return typeof filePath === "string" && filePath.length > 0 && existsSync(filePath)
@@ -226,12 +221,16 @@ let launchArguments;
 let remoteArguments = null;
 let brokerArguments = null;
 let delegationArguments = null;
+let consoleArguments = 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] === "console") {
+  launchArguments = null;
+  consoleArguments = userArguments.slice(1);
 } else if (userArguments[0] === "remote") {
   launchArguments = null;
   remoteArguments = userArguments.slice(1);
@@ -252,6 +251,7 @@ if (userArguments.length === 0) {
       "  codexhost",
       "  codexhost --version",
       "  codexhost inspect",
+      "  codexhost console",
       "  codexhost launch [launcher options]",
       "  codexhost remote install|start|stop|status|uninstall",
       "  codexhost broker install|status|stop|uninstall",
@@ -297,7 +297,17 @@ if (launchArguments?.[0] === "launch") {
   launchArguments = ["launch", ...extras, ...launchArguments.slice(1)];
 }
 
-if (delegationArguments !== null) {
+if (consoleArguments !== null) {
+  if (consoleArguments.length > 0) fail("console accepts no arguments");
+  if (!existsSync(consoleServer)) fail(`missing console: ${consoleServer}`);
+  const child = spawn(process.execPath, [consoleServer, "open"], {
+    env: { ...updateEnvironment, CODEXHOST_LAUNCHER_EXECUTABLE: launcher },
+    stdio: "inherit",
+    windowsHide: true,
+  });
+  child.on("error", (error) => fail(error.message));
+  child.on("exit", (code) => process.exit(code ?? 1));
+} else if (delegationArguments !== null) {
   const child = spawn(
     process.execPath,
     [hostRuntime, "--codexhost-delegation-cli", ...delegationArguments],

package/package.json

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