Delegate coding tasks to Codex AI for implementation, analysis, and alternative solutions...
This skill enables Claude Code to execute tasks using OpenAI's Codex AI agent.
The codex-kkp-cli is a Codex Agent CLI tool, allowing you to:
# Direct call with platform-specific executable
executables/codex-kkp-cli-{platform} --cd=/absolute/path/to/project [options] "<task_description>"
Where {platform} is one of:
macosx64 - macOS Intel (x86_64)macosarm64 - macOS Apple Silicon (ARM64)linuxx64 - Linux x86_64linuxarm64 - Linux ARM64mingwx64 - Windows x86_64Platform Auto-Detection Helper: A platform detection script is provided to help identify your current platform:
On Windows, Just use mingwx64 platform directly, no need to use script detection.
# Unix/Linux/macOS
codex-kkp-cli-platform
# Outputs: macosx64, macosarm64, linuxx64, or linuxarm64
This is AI-to-AI communication between You and Codex. PRIORITIZE ACCURACY AND PRECISION over human readability. Use structured data, exact technical terms, full paths, and precise details. NO conversational formatting needed.
| Parameter | Description |
|---|---|
| Task | The task description (positional argument, must be quoted) |
--cd=<dir> |
Working directory (ABSOLUTE PATH REQUIRED) |
| Parameter | Description |
|---|---|
--session=<id> |
Session ID (STRONGLY RECOMMENDED for follow-up chats to maintain context) |
--sandbox=<mode> |
Sandbox mode. Default is read-only. See sandbox-modes.md |
--full-auto |
Allow Codex to edit files automatically |
--image=<path> |
Include an image file (ABSOLUTE PATH, can repeat) |
--skip-git-repo-check[=BOOL] |
Skip Git repository check. Default is true. Use =false to enable Git check |
For output options (--full, --output-last-message, --output-schema), see outputs.md.
NOTE that parameters and values are connected by an EQUAL SIGN =, not a space.
Returns JSON with "type": "SUCCESS" or "type": "ERROR".
{
"type": "SUCCESS",
"session": "xxxxxxx",
"content": {
"agentMessages": "I've analyzed the code and found...",
"fileChanges": [...], // Optional
"nonFatalErrors": [...] // Optional
}
}
fileChanges and nonFatalErrors is nullable.session field.New Session:
executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"
Continue Previous Session:
executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"
More examples: examples.md
