| verified | true |
| lastVerifiedAt | 2026-03-15 |
| name | omega-codex-cli |
| description | Shell out to OpenAI Codex CLI for headless code generation, analysis, and question-answering. Optimized for code tasks. Requires OPENAI_API_KEY env var. |
| version | 1.1.0 |
| model | sonnet |
| invoked_by | both |
| user_invocable | true |
| tools | ["Bash","Read"] |
| best_practices | ["Always run verify-setup.mjs before first invocation","Ensure OPENAI_API_KEY env var is set before use","Use --json for JSONL event stream output in automation pipelines","Use --timeout-ms for long-running tasks to prevent hangs","Use --sandbox for isolated workspace-write mode"] |
| error_handling | graceful |
| streaming | supported |
| source | builtin |
| trust_score | 100 |
| provenance_sha | 66a8622b60104fdd |
Codex CLI Skill
Headless wrapper for OpenAI Codex CLI. Passes prompt as positional arg to codex exec "PROMPT".
Optimized for code generation and analysis. Requires OPENAI_API_KEY.
When to Use
- Code generation tasks needing OpenAI/GPT model perspective
- Cross-validation of code solutions with a non-Claude model
- Tasks benefiting from Codex's code optimization focus
- Multi-LLM consultation workflows
Usage
Ask a question
node .claude/skills/omega-codex-cli/scripts/ask-codex.mjs "Implement a Redis caching layer for Express"
With timeout
node .claude/skills/omega-codex-cli/scripts/ask-codex.mjs "Refactor this module" --timeout-ms 120000
JSONL streaming output
node .claude/skills/omega-codex-cli/scripts/ask-codex.mjs "Generate unit tests" --json
Sandbox mode
node .claude/skills/omega-codex-cli/scripts/ask-codex.mjs "Write and test a sort algorithm" --sandbox
Availability Check
node .claude/skills/omega-codex-cli/scripts/verify-setup.mjs
Scripts
| Script | Purpose |
|---|
ask-codex.mjs | Core headless wrapper — prompt as positional arg |
parse-args.mjs | Argument parser (--model, --json, --sandbox, --timeout-ms) |
verify-setup.mjs | Availability check (CLI + OPENAI_API_KEY) |
format-output.mjs | JSONL event stream normalization |
Models
| Model ID | Description | When to Use |
|---|
codex-mini-latest | Default. Fine-tuned o4-mini. Low-latency code Q&A. $1.50/$6 per 1M. |
