Codex KKP

KKP: Kotlin Claude Code sKill Plugin.

Overview

中文 | English

Codex KKP is a Claude Code Plugin that enables seamless integration with Codex AI Agent for code analysis, implementation, and collaboration tasks. Provides a subagent and a skill for Codex AI Agent.

Features

• Multi-platform Support: Native binaries for macOS, Linux, and Windows
• Streamlined results: By default, only completed results are returned to reduce token consumption.
• Sandbox Modes: Configurable security levels (read-only, workspace-write, danger-full-access)
• Session Management: Resume previous sessions and maintain context
• Claude Code Subagents: Run subagents in parallel to improve performance
• Sugar-Free, Calorie-Free: Very healthy

Usage

After installation and configuration, you can use the Codex KKP plugin within Claude Code. The plugin provides a subagent and a skill for code analysis, implementation, and collaboration tasks.

You can verify successful installation by using /agents or by asking "What skills do you have?". Once successfully installed, you can prompt Claude Code to use Codex subagents or skills through prompts, for example:

Actively collaborate deeply with codex and subagents for task coordination and code review, ensure code quality, and perform tasks concurrently

Use Codex to review code changes

Claude Code will decide on its own whether to use Skills or agents based on the prompts.

File Operations

codex-kkp requires codex to use sandbox=read-only mode by default. If you need codex to directly modify files, Claude Code must specify the correct sandbox=workspace-write mode or add the --full-auto parameter (more dangerous) when calling codex-kkp.

This is mentioned in the skills progressive documentation, but if Claude Code still cannot understand it on its own, you can include these details in your prompts.

Codex will return file operation content, provided it uses tool APIs like apply_patch rather than some Bash/Command operations.

Installation

Download from repository

1. Download/Clone source from repository

1.1 Download source

Download the source code for Branch plugins/release and extract it.

1.2 Clone source

OR clone the repository and check out Branch plugins/release .

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

2. Add into Claude Code's marketplace

Run claude:

claude

Use /plugin:

/plugin

Choose Add marketplace:

> Add marketplace

and enter the local path where you downloaded/cloned the repository.

Download from releases

Go to the releases and select a version (such as the latest version).

Select the content you need from assets, download it, and configure it:

1. Download marketplace zip file

The compressed file codex-agent-collaboration-marketplace.zip in Assets is a complete marketplace package that includes plugins and skills.

After downloading and extracting, run Claude Code:

claude

Use the /plugin command:

/plugin

Choose Add marketplace:

> Add marketplace

Then enter the local path of your extracted marketplace directory (the directory containing the .claude-plugin directory).

2. Download skills zip file

The compressed file codex-agent-collaboration.zip in Assets contains a unified multi-platform skill bundle. You can download and unzip it, then place the extracted directory in your skills directory (e.g., <PROJECT_DIR>/.claude/skills/codex-agent-collaboration/).

This single ZIP file includes executables for all supported platforms:

• macOS x86_64 (Intel) - executables/codex-kkp-cli-macosx64
• macOS ARM64 (Apple Silicon) - executables/codex-kkp-cli-macosarm64
• Linux x86_64 - executables/codex-kkp-cli-linuxx64
• Linux ARM64 - executables/codex-kkp-cli-linuxarm64
• Windows x86_64 - executables/codex-kkp-cli-mingwx64

Claude Code will automatically select the appropriate executable for your system.

3. Download executable binary file

Standalone binary files (e.g., codex-kkp-cli-macosx64, codex-kkp-cli-mingwx64) in Assets are raw executable binaries for each platform. You can download only the executable file for your platform and design the skills yourself.

Note: All executables use uniform naming without file extensions (including Windows (mingwx64) builds).

Configuration

Once you've finished installing the plugin, you can proceed to configure some of your settings in advance.

Edit the .claude/settings.local.json file in your project and add the following configuration to property permissions.allow:

Install skill only

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

Install full plugin via marketplace

{
  "permissions": {
    "allow": [
      "Skill(codex-agent-collaboration-plugin:codex-agent-collaboration)",
      "Bash(~/.claude/marketplace/codex-kkp-skills-marketplace/codex-agent-collaboration-plugin/skills/codex-agent-collaboration/executables/codex-kkp-cli-macosx64:*)"
    ]
  }
}

If loading locally, then ~/.claude/marketplace/ should be replaced with the directory of your locally downloaded codex-kkp-skills-marketplace.

In Bash, the path refers to the executable file within the installed plugin package that corresponds to your system platform. You may need to make slight adjustments based on the actual situation.

Uninstall

Sometimes, when you try to update or uninstall a marketplace, due to issues with the Claude Code CLI itself, the plugin may not be completely uninstalled. This can lead to problems such as being unable to completely clear the plugin's activation, or being unable to enable/re-enable plugins when reloading/reinstalling the marketplace. If you encounter this issue, you can go to the plugins subdirectory in Claude Code's configuration directory, for example:

~/.claude/plugins

Manually clean up the configuration files like installed_plugins.json and known_marketplaces.json to remove the marketplaces and plugins you have already uninstalled, then restart a new CLI.

For this reason, it is recommended to uninstall any plugins before removing marketplace.

License

This project is licensed under the MIT License - see the LICENSE file for details.