#!/usr/bin/env node // Unified entry point for the Codex CLI. /* * Behavior * ========= * 1. By default we import the JavaScript implementation located in * dist/cli.js. * * 2. Developers can opt-in to a pre-compiled Rust binary by setting the * environment variable CODEX_RUST to a truthy value (`1`, `true`, etc.). * When that variable is present we resolve the correct binary for the * current platform / architecture and execute it via child_process. * * If the CODEX_RUST=1 is specified and there is no native binary for the * current platform / architecture, an error is thrown. */ // Only imported dynamically when needed – see below. import fs from "fs"; import path from "path"; import { fileURLToPath, pathToFileURL } from "url"; // Determine whether the user explicitly wants the Rust CLI. // __dirname equivalent in ESM const __filename = fileURLToPath(import.meta.url); const __dirname = path.dirname(__filename); // For the @native release of the Node module, the `use-native` file is added, // indicating we should default to the native binary. For other releases, // setting CODEX_RUST=1 will opt-in to the native binary, if included. const wantsNative = fs.existsSync(path.join(__dirname, "use-native")) || (process.env.CODEX_RUST != null ? ["1", "true", "yes"].includes(process.env.CODEX_RUST.toLowerCase()) : false); // Try native binary if requested. if (wantsNative) { 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; default: break; } if (!targetTriple) { throw new Error(`Unsupported platform: ${platform} (${arch})`); } const binaryPath = path.join(__dirname, "..", "bin", `codex-${targetTriple}`); /* * 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. */ const { spawn } = await import("child_process"); const child = spawn(binaryPath, process.argv.slice(2), { stdio: "inherit", }); 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. 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 behaviour of // exiting immediately; once the child has been signalled 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. child.on("exit", (code, signal) => { if (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, signal); } else { process.exit(code ?? 1); } }); // There is nothing more for the parent to do here – wait until the child // terminates or a signal is received. We deliberately do *not* continue on // to the JavaScript CLI fallback below, so we simply return from the current // module evaluation by awaiting the child's "exit" event. await new Promise(() => {}); } else { // Fallback: execute the original JavaScript CLI. // Resolve the path to the compiled CLI bundle const cliPath = path.resolve(__dirname, "../dist/cli.js"); const cliUrl = pathToFileURL(cliPath).href; // Load and execute the CLI try { await import(cliUrl); } catch (err) { // eslint-disable-next-line no-console console.error(err); process.exit(1); } }