name	codex-agent-collaboration
description	Execute tasks using Codex AI agent for code analysis, implementation, and collaboration

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

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

# 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".

{
  "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:

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

codex-agent-collaboration

Install Skill

SKILL.md