explaingit

ashinno/codex-claude-collab

★ 22PythonAudience · developerComplexity · 3/5Setup · moderate

TLDR

A plugin for OpenAI Codex that makes Codex and Claude Code work as a team, Codex plans the task and reviews results while Claude Code does the actual file editing, automating a two-AI collaboration loop on your local machine.

Mindmap

mindmap
  root((codex-claude-collab))
    What it does
      Dual AI collaboration
      Codex plans and reviews
      Claude Code edits files
    Tech stack
      Python
      Node.js npx
      OpenAI Codex
      Claude Code
    Use cases
      Task delegation
      Automated coding loop
      File editing handoff
    Setup
      npx install
      Single machine
      Restart Codex
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Give Codex a programming task and have it automatically delegate the file editing to Claude Code, then review the result before responding to you.

USE CASE 2

Speed up coding workflows by combining Codex's planning and review strengths with Claude Code's file-editing capabilities in a single automated loop.

USE CASE 3

Install the skill with one npx command and start using it immediately inside an existing Codex session without manual configuration.

USE CASE 4

Use the collaboration loop for tasks like refactoring or feature implementation where planning and editing are naturally separate steps.

Tech stack

PythonNode.jsnpxOpenAI CodexClaude Code

Getting it running

Difficulty · moderate Time to first run · 30min

Requires both OpenAI Codex and Claude Code installed locally on the same machine before installing the skill.

No license information is provided in the explanation.

In plain English

This repository is a skill, meaning a plugin, that makes two AI coding assistants work together in a coordinated way: Codex from OpenAI and Claude Code from Anthropic. Each assistant takes a different role. Codex does the planning, hands the actual coding work to Claude Code, and then reviews what Claude produced before reporting back to you. The goal is to combine Codex's planning and review abilities with Claude Code's file-editing capabilities in a single automated loop. When you invoke the skill inside a Codex session and give it a programming task, Codex decides whether the task is a good candidate for delegation. If it is, Codex launches Claude Code in the background, captures the output while Claude edits files in your workspace, and then reads through the changes before responding. This keeps Codex responsible for the final result while Claude handles the hands-on implementation. Installation uses a single terminal command with npx, the standard Node.js package runner, which places the skill files in the correct location inside your Codex installation. You can also clone the repository manually if you prefer. After installing, you restart Codex and invoke the skill by name in your next message. The skill is built for local use where both Codex and Claude Code are installed on the same machine. It skips per-tool approval prompts for Claude's edits within the shared workspace, which makes the handoff faster, but the README is explicit that this does not bypass credentials, production system access, or destructive commands. The safety boundary applies only to local workspace file edits.

Copy-paste prompts

Prompt 1
I have codex-claude-collab installed. Refactor this module to separate concerns into smaller functions: [paste code]. Let Codex plan the changes and Claude Code apply them.
Prompt 2
Help me understand which types of programming tasks codex-claude-collab delegates to Claude Code versus handles directly inside Codex.
Prompt 3
I just installed codex-claude-collab with npx. Show me how to restart Codex and invoke the skill with a simple file creation task to verify it works.
Prompt 4
Using codex-claude-collab, add error handling to every async function in this file: [paste code]. Walk me through what each AI does in the handoff.
Open on GitHub → Explain another repo

← ashinno on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.