Skip to content
Ralph logo Ralph

Codex CLI

Prerequisites

Section titled “Prerequisites”

Install the Codex CLI:

Terminal window
npm install -g @openai/codex

Configuration

Section titled “Configuration”
{
  "agent": "codex",
  "model": "o3"
}

How Ralph Uses It

Section titled “How Ralph Uses It”

Ralph spawns Codex CLI with:

Terminal window
codex exec "<boot prompt>" --json
  • exec — non-interactive execution subcommand
  • --json — structured JSON output
  • No --max-turns support — ralph uses its timeout mechanism

Agent Instructions

Section titled “Agent Instructions”

Ralph’s loop prompt is self-contained — it does not generate or manage AGENTS.md or any other agent-specific instructions file. All methodology content, roles, and behavioral rules are injected directly into the agent session.