usecli-codex
Overview
Use OpenAI Codex CLI as an external worker inside a Claude Code workflow.
Best for:
- implementation-oriented feedback
- code-aware review
- execution-heavy coding tasks
Install
This sub-skill can be installed independently:
skill install https://github.com/Harzva/usecli-codex
Or manually:
git clone https://github.com/Harzva/usecli-codex.git
mkdir -p ~/.claude/skills
ln -s $(pwd) ~/.claude/skills/usecli-codex
Command
bash ~/.claude/skills/usecli-codex/scripts/usecli-codex.sh --prompt "<prompt>"
Or with a prompt file:
bash ~/.claude/skills/usecli-codex/scripts/usecli-codex.sh --prompt-file <path>
Verification
Run the local smoke test:
bash ~/.claude/skills/usecli-codex/tests/test_wrapper.sh
Environment Variables
| Variable | Purpose | Default |
|---|---|---|
USECLI_CODEX_BIN |
Codex executable | codex |
USECLI_CODEX_MODEL |
Model override | (none) |
USECLI_CODEX_OUTPUT_FILE |
Last message output | (none) |
USECLI_CODEX_TIMEOUT |
Timeout seconds | (none) |
Good Fits
- When you need OpenAI-family reasoning in a specific task
- When the control plane stays in Claude Code but you want Codex for code execution
- When you want implementation-oriented review of a design or plan
Notes
- Uses
codex exec --skip-git-repo-checkin non-interactive mode - Requires local Codex CLI installation and authentication
- For first-time setup, see the official Codex documentation
Resources
bin/usecli-codex.sh
The wrapper script. Sources bin/usecli-lib.sh for shared functionality.
examples/workflows/gemini-codex-review.sh
Demonstrates Gemini + Codex review workflow.