codex-agent-collaboration

Execute tasks using Codex AI agent for code analysis, implementation, and collaboration

⭐17stars🔀1forks📁View on GitHub🕐Updated Dec 13, 2025

When & Why to Use This Skill

This Claude skill integrates the Codex AI agent to automate complex programming tasks, including code implementation, deep analysis, and multi-perspective reviews. By enabling AI-to-AI collaboration, it allows developers to delegate technical challenges, explore alternative coding solutions, and ensure high-precision results through cross-verification between Claude and Codex. It is designed for high-stakes coding environments where accuracy and diverse technical perspectives are critical.

Use Cases

  • Complex Code Implementation: Delegate specific feature development or boilerplate generation to the Codex agent for rapid prototyping and implementation.
  • Multi-Agent Code Review: Use Codex as a secondary perspective to analyze existing codebases for potential bugs, security vulnerabilities, or optimization opportunities.
  • Architectural Exploration: Generate and compare multiple technical approaches for a single problem to determine the most efficient implementation strategy.
  • Cross-Verification: Validate complex logic by having Claude and Codex independently solve the same problem and comparing the outputs for consistency and precision.
  • Automated Refactoring: Use the agent to suggest and apply alternative code structures or modern syntax improvements to legacy codebases.
namecodex-agent-collaboration
descriptionDelegate 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.

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