#!/usr/bin/env node // Unified entry point for the Codex CLI. import { spawn } from "node:child_process"; import { existsSync } from "fs"; import { createRequire } from "node:module"; import path from "path"; import { fileURLToPath } from "url"; // __dirname equivalent in ESM const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename); const require = createRequire(import.meta.url); const PLATFORM_PACKAGE_BY_TARGET = { "x86_64-unknown-linux-musl": "@openai/codex-linux-x64", "aarch64-unknown-linux-musl": "@openai/codex-linux-arm64", "x86_64-apple-darwin": "@openai/codex-darwin-x64", "aarch64-apple-darwin": "@openai/codex-darwin-arm64", "x86_64-pc-windows-msvc": "@openai/codex-win32-x64", "aarch64-pc-windows-msvc": "@openai/codex-win32-arm64", }; const { platform, arch } = process; let targetTriple = null; switch (platform) { case "linux": case "android": switch (arch) { case "x64": targetTriple = "x86_64-unknown-linux-musl"; break; case "arm64": targetTriple = "aarch64-unknown-linux-musl"; break; default: break; } break; case "darwin": switch (arch) { case "x64": targetTriple = "x86_64-apple-darwin"; break; case "arm64": targetTriple = "aarch64-apple-darwin"; break; default: break; } break; case "win32": switch (arch) { case "x64": targetTriple = "x86_64-pc-windows-msvc"; break; case "arm64": targetTriple = "aarch64-pc-windows-msvc"; break; default: break; } break; default: break; } if (!targetTriple) { throw new Error(`Unsupported platform: ${platform} (${arch})`); } const platformPackage = PLATFORM_PACKAGE_BY_TARGET[targetTriple]; if (!platformPackage) { throw new Error(`Unsupported target triple: ${targetTriple}`); } const codexBinaryName = process.platform === "win32" ? "codex.exe" : "codex"; const localVendorRoot = path.join(__dirname, "..", "vendor"); const localBinaryPath = path.join( localVendorRoot, targetTriple, "codex", codexBinaryName, ); let vendorRoot; try { const packageJsonPath = require.resolve(`${platformPackage}/package.json`); vendorRoot = path.join(path.dirname(packageJsonPath), "vendor"); } catch { if (existsSync(localBinaryPath)) { vendorRoot = localVendorRoot; } else { const packageManager = detectPackageManager(); const updateCommand = packageManager === "bun" ? "bun install -g @openai/codex@latest" : "npm install -g @openai/codex@latest"; throw new Error( `Missing optional dependency ${platformPackage}. Reinstall Codex: ${updateCommand}`, ); } } if (!vendorRoot) { const packageManager = detectPackageManager(); const updateCommand = packageManager === "bun" ? "bun install -g @openai/codex@latest" : "npm install -g @openai/codex@latest"; throw new Error( `Missing optional dependency ${platformPackage}. Reinstall Codex: ${updateCommand}`, ); } const archRoot = path.join(vendorRoot, targetTriple); const binaryPath = path.join(archRoot, "codex", codexBinaryName); // Use an asynchronous spawn instead of spawnSync so that Node is able to // respond to signals (e.g. Ctrl-C / SIGINT) while the native binary is // executing. This allows us to forward those signals to the child process // and guarantees that when either the child terminates or the parent // receives a fatal signal, both processes exit in a predictable manner. function getUpdatedPath(newDirs) { const pathSep = process.platform === "win32" ? ";" : ":"; const existingPath = process.env.PATH || ""; const updatedPath = [ ...newDirs, ...existingPath.split(pathSep).filter(Boolean), ].join(pathSep); return updatedPath; } /** * Use heuristics to detect the package manager that was used to install Codex * in order to give the user a hint about how to update it. */ function detectPackageManager() { const userAgent = process.env.npm_config_user_agent || ""; if (/\bbun\//.test(userAgent)) { return "bun"; } const execPath = process.env.npm_execpath || ""; if (execPath.includes("bun")) { return "bun"; } if ( __dirname.includes(".bun/install/global") || __dirname.includes(".bun\\install\\global") ) { return "bun"; } return userAgent ? "npm" : null; } const additionalDirs = []; const pathDir = path.join(archRoot, "path"); if (existsSync(pathDir)) { additionalDirs.push(pathDir); } const updatedPath = getUpdatedPath(additionalDirs); const env = { ...process.env, PATH: updatedPath }; const packageManagerEnvVar = detectPackageManager() === "bun" ? "CODEX_MANAGED_BY_BUN" : "CODEX_MANAGED_BY_NPM"; env[packageManagerEnvVar] = "1"; const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit", env, }); child.on("error", (err) => { // Typically triggered when the binary is missing or not executable. // Re-throwing here will terminate the parent with a non-zero exit code // while still printing a helpful stack trace. // eslint-disable-next-line no-console console.error(err); process.exit(1); }); // Forward common termination signals to the child so that it shuts down // gracefully. In the handler we temporarily disable the default behavior of // exiting immediately; once the child has been signaled we simply wait for // its exit event which will in turn terminate the parent (see below). const forwardSignal = (signal) => { if (child.killed) { return; } try { child.kill(signal); } catch { /* ignore */ } }; ["SIGINT", "SIGTERM", "SIGHUP"].forEach((sig) => { process.on(sig, () => forwardSignal(sig)); }); // When the child exits, mirror its termination reason in the parent so that // shell scripts and other tooling observe the correct exit status. // Wrap the lifetime of the child process in a Promise so that we can await // its termination in a structured way. The Promise resolves with an object // describing how the child exited: either via exit code or due to a signal. const childResult = await new Promise((resolve) => { child.on("exit", (code, signal) => { if (signal) { resolve({ type: "signal", signal }); } else { resolve({ type: "code", exitCode: code ?? 1 }); } }); }); if (childResult.type === "signal") { // Re-emit the same signal so that the parent terminates with the expected // semantics (this also sets the correct exit code of 128 + n). process.kill(process.pid, childResult.signal); } else { process.exit(childResult.exitCode); }