codex-kkp

🥈Silver

Codex KKP is a Claude Code Plugin that integrates with Codex AI Agent for code analysis, implementation, and collaboration. It benefits developers and operations teams by automating repetitive coding tasks and enhancing code quality. The plugin connects to Claude Code and supports Kotlin Multiplatform.

2510Updated 2mo ago

Intermediate30min to implementautomation

Saves ~40 min per use

Quick InstallView Source

git clone https://github.com/ForteScarlet/codex-kkp.git

Works with:

Claude

Overview

About This Skill

Codex KKP is a Claude Code plugin that enables seamless integration with Codex AI Agent for code analysis, implementation, and collaboration tasks. It provides configurable sandbox modes (read-only, workspace-write, danger-full-access) for secure file operations and supports session management to maintain context across work. The plugin runs Claude Code subagents in parallel to improve performance and reduce token consumption by returning only completed results. Developers and operations teams benefit from automated repetitive coding tasks, enhanced code quality through collaborative review, and multi-platform support for macOS, Linux, and Windows.

How to Use

[{"step":"Install the Codex KKP plugin in your Claude Code environment by running `claude plugins install codex-kkp` in your terminal.","tip":"Ensure you have Kotlin Multiplatform plugin installed in your IDE for full compatibility."},{"step":"Navigate to your Kotlin Multiplatform project root directory and run `claude codex-kkp analyze --project [PROJECT_NAME] --issue [SPECIFIC_ISSUE]` to initiate the analysis.","tip":"For large projects, use `--target environment` to focus on specific platforms (e.g., `--target ios` or `--target android`)."},{"step":"Review the generated report in the `codex-kkp-report.md` file. Use the prioritized fixes to create GitHub/GitLab issues or Jira tickets.","tip":"Copy the code snippets directly into your IDE and verify the changes compile before committing."},{"step":"Run the recommended tests using `./gradlew test` or your project's test command. Use `--no-daemon` flag for consistent CI results.","tip":"For performance-critical projects, use `--benchmark` flag to generate detailed performance metrics."},{"step":"Commit the fixes with a message referencing the Codex KKP report (e.g., \"Fix memory leak in NoteRepository - Codex KKP #123\").","tip":"Tag the commit with `codex-kkp` for easy filtering in your repository."}]

Use Cases

Collaborative code review with Claude Code subagents for quality assurance

Automated code analysis and implementation tasks across projects

Resuming previous analysis sessions with maintained context

Multi-platform code development on macOS, Linux, and Windows

Setup & Installation

Quick Install

No install command available. Check the GitHub repository for manual installation instructions.

Alternative Install (Git Clone)

git clone https://github.com/ForteScarlet/codex-kkp

Requirements

Claude Code or compatible AI agent
Works with: Claude

Quick Start Guide

Install the Skill

Copy the install command above and run it in your terminal.

Open Your AI Agent

Launch Claude Code, Cursor, or your preferred AI coding agent.

Try It Out

Use the prompt template or examples below to test the skill.

Customize

Adapt the skill to your specific use case and workflow.

Usage Examples

Prompt Template

Use Codex KKP to analyze the [PROJECT_NAME] Kotlin Multiplatform codebase for [SPECIFIC_ISSUE]. Focus on [AREAS_OF_INTEREST] and provide a prioritized list of fixes with code snippets. Include performance impact estimates and testing recommendations. Target: [TARGET_ENVIRONMENT].

Example Output

## Codex KKP Analysis Report for *KotlinNotes* (v2.4.1)

**Critical Issues Found (3)**
1. **Memory Leak in Shared Module**
   - Location: `shared/src/commonMain/kotlin/com/notes/data/NoteRepository.kt`
   - Issue: Coroutine scope not cancelled in `fetchNotes()` leading to 47% memory retention after 1000 iterations
   - Fix: Wrap in `CoroutineScope(Dispatchers.Default).launch { ... }` with `finally { cancel() }`
   - Impact: 18% performance degradation on iOS 17+ devices
   - Test: Add `repeat(1000) { fetchNotes() }` to `MemoryLeakTest.kt`

2. **Platform-Specific Crash in iOS**
   - Location: `shared/src/iosMain/kotlin/com/notes/utils/PlatformUtils.kt`
   - Issue: Force-unwrapping `NSLocale.current` crashes on simulator
   - Fix: Replace `NSLocale.current.identifier` with `NSLocale.preferredLanguages.firstOrNull() ?: "en_US"`
   - Impact: 12% crash rate on iOS Simulator (all versions)
   - Test: Add `testPlatformUtils()` to `PlatformTest.kt`

3. **Build Configuration Mismatch**
   - Location: `build.gradle.kts` (root project)
   - Issue: Kotlin version 1.9.20 conflicts with Ktor 2.3.7
   - Fix: Update Ktor to 2.3.10 and add `kotlin.native.binary.memoryModel=experimental`
   - Impact: 30% slower build times on CI
   - Test: Run `./gradlew clean build --no-daemon`

**Recommendations**
- Prioritize Memory Leak fix (highest impact)
- Schedule Platform-Specific fix for next sprint (medium priority)
- Update build config in CI pipeline (low priority)

**Code Snippets**
```kotlin
// Fixed NoteRepository.kt
suspend fun fetchNotes(): List<Note> = coroutineScope {
    try {
        api.getNotes().also { notes -> 
            cache.store(notes) // Ensure cache is cleared
        }
    } finally {
        cancel() // Critical fix
    }
}
```

**Performance Metrics**
- Before: 1.2s average fetch time (iOS)
- After: 0.8s average fetch time (iOS)
- Memory usage reduced from 180MB to 95MB after 500 iterations

**Testing Coverage**
- Current: 68% (shared module)
- After fixes: Target 85% (add 3 new tests)

*Generated by Codex KKP v1.2.3 | Analysis completed in 4m 22s*