codex-compat

Migrate Claude Code hooks to Codex-compatible format with batch checks.

34|4|Updated Apr 20, 2026
One-click install
npx skills add https://github.com/redpanda-data/ui-harness --skill codex-compat-redpanda-data
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-compat
Source: https://github.com/redpanda-data/ui-harness/tree/main/codex-compat
Command: npx skills add https://github.com/redpanda-data/ui-harness --skill codex-compat-redpanda-data

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill unit ensures smooth integration with Codex, enhancing the collaboration between Codex and Claude Code, while also supporting dual-agent setups.

Core Features & Use Cases

  • Codex Integration: Generates .codex/hooks.json and AGENTS.md from Claude Code hooks, mapping supported hooks directly and providing fallbacks where needed.
  • Multi-Agent Workflow: Facilitates parallel and combined operation of Codex and Claude Code within the same project environment.
  • Use Case: Use this Skill when integrating Codex into an existing Claude Code project that requires Codex support for enhanced functionality and compatibility with Claude hooks.

Quick Start

Run 'codex-compat' to generate compatibility files for Codex.

Frequently Asked Questions about codex-compat

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Claude Code hooks to Codex format?

Migrating Claude Code hooks to Codex format involves generating a .codex/hooks.json file and AGENTS.md. This process maps supported hooks directly and provides fallbacks for unsupported events to ensure compatibility.

Can I run Codex and Claude Code together in the same project?

Yes, running Codex and Claude Code together in the same project is supported. This dual-agent setup uses generated compatibility files to enable parallel and combined operation across both systems.

What files are generated when integrating Codex with Claude Code?

Integrating Codex with Claude Code generates .codex/hooks.json and AGENTS.md files. These files map existing hooks to the Codex-compatible format and ensure smooth cross-agent functionality.

Does Codex compatibility support all Claude Code hook events?

Not all Claude Code hook events are supported in Codex compatibility. The process maps supported hooks directly but performs batch checks and provides fallbacks for unsupported events.

Do I need prior experience with both systems to set up Codex compatibility?

Yes, setting up Codex compatibility requires familiarity with both Codex and Claude Code systems. This prerequisite knowledge is necessary to properly adjust compatibility settings and enable cross-agent functionality.