spawn("codex") fails on Windows — missing shell: true and windowsHide: true

[cosyeezz]

Problem

On Windows, the spawn("codex", ["app-server"], ...) call in scripts/lib/app-server.mjs (line ~188) fails with ENOENT because codex is installed as a batch/cmd wrapper (e.g. codex.cmd). Node.js child_process.spawn on Windows requires shell: true to resolve .cmd/.bat extensions via PATH.

Additionally, when shell: true is set, a visible cmd.exe console window briefly flashes on screen. Setting windowsHide: true prevents this.

Environment

• Windows 11 Pro (10.0.22631)
• Node.js v22.x
• Codex CLI installed globally via npm
• Claude Code plugin codex@openai-codex v1.0.1

Current code

this.proc = spawn("codex", ["app-server"], {
  cwd: this.cwd,
  env: this.options.env,
  stdio: ["pipe", "pipe", "pipe"]
});

Suggested fix

this.proc = spawn("codex", ["app-server"], {
  cwd: this.cwd,
  env: this.options.env,
  stdio: ["pipe", "pipe", "pipe"],
  shell: process.platform === "win32",
  windowsHide: true
});

shell is conditionally enabled only on Windows so Unix behavior is unchanged. windowsHide is a no-op on non-Windows platforms.

Steps to reproduce

1. Install Codex CLI globally on Windows (npm i -g @openai/codex)
2. Enable the codex@openai-codex plugin in Claude Code
3. Invoke /codex:rescue with any task
4. Observe ENOENT error — spawn codex ENOENT

[9thLevelSoftware]

Confirming this affects my setup as well.

• Windows 11 Pro, Node.js v22.x, @openai/codex@0.117.0
• Claude Code with codex@openai-codex plugin
• codex binary is at C:\Users\...\AppData\Roaming\npm\codex (.cmd shim)

Traced the same root cause independently:

// ENOENT — can't resolve .cmd shim without shell
spawnSync("codex", ["--version"], { encoding: "utf8" })

// Works fine
spawnSync("codex", ["--version"], { encoding: "utf8", shell: true })

The issue affects both call sites:

1. scripts/lib/app-server.mjs:188 — spawn("codex", ["app-server"], ...) (async)
2. scripts/lib/process.mjs:5 — spawnSync(command, args, ...) used by binaryAvailable() and runCommand()

The binaryAvailable check fails first, so getCodexAvailability() returns { available: false } and the review/task commands bail before even attempting the app-server spawn.

+1 on the suggested fix — shell: process.platform === "win32" + windowsHide: true at both sites.

[dkundel-openai]

This should be fixed in #55 in v1.0.2