Codex CLI Integration Textbook (Ubuntu 24.04)

Procedural API Reference for Deep Tool Integration and Edge-Case Coverage Scope: Codex CLI as shipped in the openai/codex repository snapshot provided (Rust core + Node distribution wrapper). Normative terms: MUST, MUST NOT, SHOULD, SHOULD NOT, MAY.

0. Contract Baseline

0.1 What “integration” means in this text

An “integrator” is any program, agent, IDE, CI system, daemon, or automation that:

• Launches Codex as a subprocess (interactive or non-interactive).
• Consumes Codex outputs (human text or JSONL).
• Provides inputs (prompt text, images, schemas).
• Controls configuration, sandboxing, and policy.
• Optionally runs Codex as a JSON-RPC service (app server) or as an MCP server.