Codex Cli

Codex CLI (OpenAI)

Terminal-based AI coding agent by OpenAI. Reads, edits, and runs code locally in a sandboxed environment. Built in Rust.

Detect Installation

which codex  # should return a path
codex --version

Install

npm i -g @openai/codex

Requires an OpenAI API key or ChatGPT account (prompted on first run).

Non-Interactive Usage (exec)

For programmatic invocation from Research-Claw, use codex exec:

# Basic non-interactive execution
codex exec "Refactor the auth module to use JWT tokens"

# Pipe from stdin
echo "Fix the failing test in src/utils.test.ts" | codex exec -

# Full-auto mode (workspace writes + minimal approvals)
codex exec --full-auto "Add error handling to all API routes"

# Skip all approvals (dangerous — use only in sandboxed environments)
codex exec -a never -s workspace-write "Update dependencies and fix breaking changes"

# Save final response to file
codex exec -o result.md "Explain the architecture of this project"

Key Flags

Research-Claw exec Patterns

# Delegate a complex coding task
exec("codex exec --full-auto -C /path/to/project 'Implement the feature described in TODO.md'")

# Read-only analysis
exec("codex exec -s read-only -o /tmp/analysis.md -C /path/to/project 'Analyze code quality and list issues'")

# With model selection
exec("codex exec -m gpt-5-codex --full-auto 'Fix all TypeScript type errors'")

Docs

• CLI reference: https://developers.openai.com/codex/cli/reference
• SDK (programmatic): https://developers.openai.com/codex/sdk