codex

Installs the Codex CLI (codex) as a global npm package.

devtools:
  - name: nodejs
  - name: codex

Version behaviour

Node.js

The recipe needs npm. If nodejs is declared first, that Node is used; otherwise the recipe installs the distribution’s Node.js and npm.

Example

devtools:
  - name: nodejs
    version: "24"
  - name: claude-code
  - name: codex
toolconfigs:
  - name: codex
    config:
      configToml: |
        model = "o4-mini"

Ringleader does not interpret Codex’s settings — it renders whatever you declare into ~/.codex/config.toml.

See the codex toolconfig for the full configuration surface, including how to hand Codex a verbatim config.toml.

Notes

• Unlike claude-code, installing codex does not synthesise any permission default — Codex ships with its own. A toolconfig is synthesised only to pre-trust the workstation’s working folders, and only when the workstation declares any.
• The binary lands on the system PATH.
• Works on Debian, Ubuntu, and Alpine.