gexijin OpenAI Codex CLI Skill
This skill provides integration with OpenAI's Codex CLI for code review and task execution.
Quick Reference
Code Review
Review uncommitted changes:
codex review --uncommitted
Review against a branch:
codex review --base main
Review a specific commit:
codex review --commit <sha>
Review with custom instructions:
codex review "Focus on security vulnerabilities"
Task Execution
Run a task non-interactively:
codex exec "<prompt>"
With full auto mode (sandboxed automatic execution):
codex exec --full-auto "<prompt>"
With specific model:
codex exec -m o3 "<prompt>"
Available Commands
| Command | Description |
|---|---|
codex review |
Run code review non-interactively |
codex exec |
Run tasks non-interactively |
codex |
Interactive mode |
codex apply |
Apply latest diff from Codex agent |
codex resume |
Resume previous session |
Review Command Options
| Option | Description |
|---|---|
--uncommitted |
Review staged, unstaged, and untracked changes |
--base <branch> |
Review changes against base branch |
--commit <sha> |
Review changes from a specific commit |
--title <title> |
Optional commit title for review summary |
-c model=<model> |
Use specific model |
Exec Command Options
| Option | Description |
|---|---|
-m, --model <model> |
Model to use (e.g., o3, gpt-4) |
-s, --sandbox <mode> |
Sandbox: read-only, workspace-write, danger-full-access |
--full-auto |
Low-friction sandboxed automatic execution |
-C, --cd <dir> |
Working directory |
-i, --image <file> |
Attach image(s) to prompt |
-o, --output-last-message <file> |
Write final response to file |
--json |
Output events as JSONL |
Common Use Cases
1. Quick Code Review
Review current changes before committing:
codex review --uncommitted
2. PR Review
Review all changes in a feature branch:
codex review --base main --title "Feature: Add user authentication"
3. Focused Review
Review with specific focus:
codex review --uncommitted "Focus on:
1. Security vulnerabilities
2. Error handling
3. Performance issues"
4. Automated Task
Run a coding task:
codex exec "Add input validation to all API endpoints in src/api/"
5. Code Explanation
Get explanation of complex code:
codex exec "Explain the algorithm in src/utils/ranking.R"
6. Bug Investigation
Investigate test failures:
codex exec "Investigate why tests in tests/unit/ are failing"
Sandbox Modes
| Mode | Permissions |
|---|---|
read-only |
Can read files, no writes |
workspace-write |
Can write to workspace (default with --full-auto) |
danger-full-access |
Full system access (use with caution) |
Integration with Claude Code
When using this skill:
- For code review: Use
/codex-reviewcommand or runcodex reviewdirectly - For tasks: Use
/codexcommand or runcodex execdirectly - For complex workflows: Combine Codex output with Claude Code analysis
Example Workflow
Use Codex for initial review:
codex review --uncommitted > review.txtHave Claude Code analyze and summarize:
- Read the review output
- Identify critical issues
- Suggest fixes
Best Practices
- Use
--full-autofor routine tasks - Speeds up execution with safe defaults - Specify
--basefor PR reviews - Ensures complete diff is reviewed - Add context to review prompts - Better reviews with specific focus areas
- Check sandbox mode - Use appropriate permissions for the task
- Save output for complex reviews - Use
-oflag for later analysis