Codex CLI Skill

This skill enables Claude Code to execute tasks using OpenAI's Codex AI agent.

Overview

The codex-kkp-cli is a Codex Agent CLI tool, allowing you to:

•Execute coding tasks and get implementations
•Perform code analysis and reviews
•Get alternative solutions and suggestions
•Collaborate with Codex for cross-checking implementations

Usage

Basic Syntax

bash

# 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_64
•linuxarm64 - Linux ARM64
•mingwx64 - Windows x86_64

Platform 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.

bash

# Unix/Linux/macOS
codex-kkp-cli-platform
# Outputs: macosx64, macosarm64, linuxx64, or linuxarm64

communication

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.

Required Parameters

Parameter	Description
Task	The task description (positional argument, must be quoted)
`--cd=<dir>`	Working directory (ABSOLUTE PATH REQUIRED)

Optional Parameters

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.

Response Format

Returns JSON with "type": "SUCCESS" or "type": "ERROR".

JSON

{
  "type": "SUCCESS",
  "session": "xxxxxxx",
  "content": {
    "agentMessages": "I've analyzed the code and found...",
    "fileChanges": [...],   // Optional
    "nonFatalErrors": [...] // Optional
  }
}

•fileChanges and nonFatalErrors is nullable.
•Error responses do NOT include a session field.

Quick Example

New Session:

bash

executables/codex-kkp-cli-{platform} --cd=/path/to/project "Explain the main function in Main.kt"

Continue Previous Session:

bash

executables/codex-kkp-cli-{platform} --cd=/path/to/project --session=xxxxxxx "Explain the main function in Main.kt"

More examples: examples.md