›_ Codex Issues
Codex Issues / #24672

Linux x64 npm install for 0.134.0 is missing platform artifact and CLI fails on startup

Open 💬 4 comments Opened May 27, 2026 by vimalinx
💡 Likely answer: A maintainer (etraut-openai, contributor) responded on this thread — see the highlighted reply below.

What version of Codex CLI is running?

@openai/codex@0.134.0

The CLI cannot print its own version because it exits before startup completes.

What subscription do you have?

N/A - the failure happens before authentication/model selection.

Which model were you using?

N/A

What platform is your computer?

Linux x86_64. Reproduced on an Arch Linux system using nvm-managed Node.js.

What terminal emulator and version are you using (if applicable)?

zsh shell in a terminal. Terminal emulator does not appear relevant.

What issue are you seeing?

After upgrading/installing @openai/codex@0.134.0 via npm on Linux x64, codex exits immediately with:

file:///home/<user>/.config/nvm/versions/node/v25.5.0/lib/node_modules/@openai/codex/bin/codex.js:122
  throw new Error(
        ^

Error: Missing optional dependency @openai/codex-linux-x64. Reinstall Codex: npm install -g @openai/codex@latest
    at file:///home/<user>/.config/nvm/versions/node/v25.5.0/lib/node_modules/@openai/codex/bin/codex.js:122:9
    at ModuleJob.run (node:internal/modules/esm/module_job:430:25)
    at async onImport.tracePromise.__proto__ (node:internal/modules/esm/loader:655:26)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:101:5)

Node.js v25.5.0

The same startup failure also reproduces after switching to Node.js v22.22.2 with npm v10.9.7:

Error: Missing optional dependency @openai/codex-linux-x64. Reinstall Codex: npm install -g @openai/codex@latest
...
Node.js v22.22.2

This looks like a missing npm platform artifact for the stable 0.134.0 release rather than a local Node version issue.

Registry metadata observed

@openai/codex@0.134.0 declares this optional dependency:

{
  "@openai/codex-linux-x64": "npm:@openai/codex@0.134.0-linux-x64"
}

But the target version does not exist in the npm registry:

npm view @openai/codex@0.134.0-linux-x64 version name --json

returns:

npm error code E404
npm error 404 No match found for version 0.134.0-linux-x64

Also, the version list contains these 0.134.0 stable platform variants:

0.134.0-darwin-arm64
0.134.0-darwin-x64
0.134.0-linux-arm64
0.134.0-win32-arm64
0.134.0-win32-x64
0.134.0

but it does not include:

0.134.0-linux-x64

Steps to reproduce

nvm use 22
npm uninstall -g @openai/codex
npm install -g @openai/codex@0.134.0
codex --version
# or: codex

Actual behavior

npm reports the install as successful, but the platform optional dependency is not installed. Running codex fails immediately with Missing optional dependency @openai/codex-linux-x64.

Expected behavior

npm install -g @openai/codex@0.134.0 on Linux x64 should install a usable platform native package, and codex should start normally.

Workaround

Pinning to the previous release appears to avoid the missing artifact:

npm install -g @openai/codex@0.133.0 --include=optional

The standalone installer may also avoid this npm optional dependency path.

Additional context

This resembles earlier Linux x64 optional artifact issues such as #19419, but this report is specifically for the stable 0.134.0 release metadata pointing to a missing 0.134.0-linux-x64 package version.

View original on GitHub ↗

4 Comments

etraut-openai contributor · 3 months ago

It takes a few minutes for all of the packages to upload to npm. If you install when only some packages have been uploaded, you'll see this error. If you wait a few minutes and try again, the problem should go away. Let us know if you continue to see the problem.

fxjs · 3 months ago

+1, reproduced on Arch Linux x86_64 with pnpm 10.26.1 and Node.js v24.14.0.

Same Missing optional dependency @openai/codex-linux-x64 error from @openai/codex@0.134.0. Confirmed via npm view that only 0.134.0-linux-x64 is missing from the registry — the other 5 platform packages (linux-arm64, darwin-x64, darwin-arm64, win32-x64, win32-arm64) all exist for 0.134.0.

$ for p in linux-x64 linux-arm64 darwin-x64 darwin-arm64 win32-x64 win32-arm64; do
    npm view "@openai/codex@0.134.0-\$p" version 2>&1 | tail -1
  done
# linux-x64:   404 (missing)
# linux-arm64: 0.134.0-linux-arm64  ✓
# darwin-x64:  0.134.0-darwin-x64   ✓
# darwin-arm64:0.134.0-darwin-arm64 ✓
# win32-x64:   0.134.0-win32-x64    ✓
# win32-arm64: 0.134.0-win32-arm64  ✓

Workaround pnpm add -g @openai/codex@0.133.0 works fine.

Looks like the Linux x64 publish step in the 0.134.0 release pipeline failed silently.

Liuyh0308 · 3 months ago

Same problem on Linux x86_64, Node.js v20.20.0.

file:///root/.nvm/versions/node/v20.20.0/lib/node_modules/@openai/codex/bin/codex.js:122`
  throw new Error(
        ^

Error: Missing optional dependency @openai/codex-linux-x64. Reinstall Codex: npm install -g @openai/codex@latest
    at file:///root/.nvm/versions/node/v20.20.0/lib/node_modules/@openai/codex/bin/codex.js:122:9
    at ModuleJob.run (node:internal/modules/esm/module_job:325:25)
    at async ModuleLoader.import (node:internal/modules/esm/loader:606:24)
    at async asyncRunEntryPointWithESMLoader (node:internal/modules/run_main:117:5)

Node.js v20.20.0
hanzlahabib · 2 months ago

Still reproduces on 0.140.0 after a clean npm install -g @openai/codex@latest.

Env: codex 0.140.0 · Node v24.7.0 · npm 11.5.1 · Linux x86_64 (WSL2 / Ubuntu) · glibc 2.31 · process.platform=linux, process.arch=x64

Error: Missing optional dependency @openai/codex-linux-x64. Reinstall Codex: npm install -g @openai/codex@latest
    at findCodexExecutable (.../@openai/codex/bin/codex.js:102:9)

Root cause (the platform package is installed but malformed):
The optional dep is present at …/@openai/codex/node_modules/@openai/codex-linux-x64/, but:

  1. No package.json at the package root — the dir contains only a vendor/ folder. So findCodexExecutable's package resolution fails and reports it as "missing" even though the folder exists.
  2. **It ships the musl binary inside the glibc (-linux-x64) package.** The only binary present is:

``
@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin/codex
``
i.e. the musl artifact is published under the package name that should carry the glibc x64 build.

find output:

@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/bin/codex
@openai/codex/node_modules/@openai/codex-linux-x64/vendor/x86_64-unknown-linux-musl/codex-resources/bwrap

(252 MB installed across the 6 platform optional-deps; @openai/codex-linux-x64 resolves via npm:@openai/codex@0.140.0-linux-x64.)

So on glibc Linux x64 the CLI never finds a runnable binary. Looks like a packaging/publish issue for the 0.140.0-linux-x64 artifact (missing root package.json + wrong libc variant), not a user install problem.