codex

Execute Codex CLI for code analysis, refactoring, and automated changes using HEREDOC syntax with fixed 2-hour timeout.

• Run Codex CLI for code analysis, refactoring, and automated changes
• Supports file references via @syntax and multiple models
• Primary method for code edits and tests with fallback policies
• Enforces foreground execution and structured JSON output

• Mandatory HEREDOC syntax (<<'EOF') to avoid shell quoting issues
• Fixed timeout of 7200000 ms (2 hours) in all invocations
• Foreground only execution; no background or BashOutput streaming
• Supports @file references and structured JSON response parsing
• Fallback only on service down or two consecutive failures
• Session resumable with session ID and task continuity

1. 1.Use HEREDOC syntax in foreground with codex-wrapper - [working_dir] <<'EOF'
2. 2.Set environment variable CODEX_TIMEOUT (in ms) to override 2-hour default
3. 3.Include @file references in task content for file-based analysis
4. 4.Resume sessions using codex-wrapper resume <session_id> with task continuation
5. 5.Never use background execution or append & to commands
6. 6.For simple tasks, use direct quoting only if no special characters