Delegate coding tasks to Codex AI for implementation, analysis, and alternative solutions. Use when you need a second AI perspective, want to explore different approaches, or need specialized Codex capabilities for complex coding tasks.
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
Search for places (restaurants, cafes, etc.) via Google Places API proxy on localhost.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Start voice calls via the OpenClaw voice-call plugin.
Notion API for creating and managing pages, databases, and blocks.
Gemini CLI for one-shot Q&A, summaries, and generation.
Category:developer