GitHub - antorsae/dual-agent: Dual-agent development environment pairing Claude Code with Codex CLI in a collaborative tmux session

https://github.com/antorsae/dual-agent • Jan 17, 2026 17:11

Extracto

Dual-agent development environment pairing Claude Code with Codex CLI in a collaborative tmux session - antorsae/dual-agent

Resumen

Resumen Principal

El Dual Agent Development Environment es una innovadora plataforma de desarrollo colaborativo que fusiona las capacidades de múltiples modelos de inteligencia artificial: Claude Code (Anthropic), Codex CLI (OpenAI) y ChatGPT Pro (GPT-5.2 Pro). Su objetivo principal es potenciar la velocidad de desarrollo con controles de calidad rigurosos y perspectivas diversas, aprovechando las fortalezas específicas de cada agente. Mientras que Claude Code sobresale en iteración rápida y prototipado, Codex CLI se enfoca en revisiones de código profundas, implementación de características complejas y análisis de vulnerabilidades de seguridad, beneficiándose de un contexto de hasta 200k tokens. Por su parte, ChatGPT Pro aporta una capacidad de pensamiento extendido para análisis complejos y revisiones que requieren mayor tiempo. Esta sinergia permite una orquestación sofisticada de tareas, abordando desde la refactorización rápida hasta el diseño de algoritmos intrincados y la gestión de casos extremos.

Elementos Clave

Sinergia y Roles de los Agentes AI: El entorno asigna roles especializados a cada AI para optimizar el flujo de trabajo. Claude Code actúa como el orquestador principal, ideal para la iteración rápida y el prototipado, así como para la planificación y el cambio de contexto. Codex CLI se encarga de la revisión de código profunda (seguridad, errores, rendimiento), la implementación de características complejas, el análisis de vulnerabilidades y la revisión de planes, gracias a su amplio contexto de 200k. ChatGPT Pro se utiliza para análisis complejos y revisiones de código de pensamiento extendido que pueden durar entre 5 y 30 minutos, proporcionando una segunda opinión arquitectónica meticulosa.
Tres Modos de Uso Integrados: El sistema ofrece flexibilidad a través de tres opciones de interacción. La primera, y recomendada, son las MCP Tools, donde Claude Code puede invocar directamente a Codex para revisiones o implementaciones mediante lenguaje natural. La segunda es el Tmux Dual-Pane, que permite una interacción lado a lado con Claude y Codex visiblemente en una sesión dividida. La tercera es la ChatGPT Code Review a través de la integración de Claude Code con el navegador Chrome, ideal para revisiones profundas y no bloqueantes de GPT-5.2 Pro.
Configuración y Prerrequisitos Esenciales: Para operar el entorno, se requieren herramientas fundamentales como tmux (multiplexor de terminal), jq (procesador JSON) y Node.js (para el servidor MCP), además de las CLI de Claude Code y Codex CLI. El script setup-dual-agent.sh automatiza la configuración inicial, incluyendo la construcción del servidor codex-delegate MCP, la instalación de habilidades específicas para Claude y Codex, la configuración de permisos y la inicialización de un directorio de colaboración (.agent-collab/).
Arquitectura y Comunicación Subyacente: La arquitectura se basa en Claude Code como el centro de mando. Las MCP Tools de Claude se comunican con un servidor codex-delegate MCP basado en Node.js que, a su vez, genera procesos de Codex CLI. Para la comunicación entre agentes en el modo Tmux, se utiliza un mecanismo de IPC (Inter-Process Communication) basado en archivos en el directorio .agent-collab/, permitiendo que Claude y Codex compartan tareas y respuestas. La integración con ChatGPT Pro se realiza a través de la integración de Chrome de Claude Code, utilizando inyección de JavaScript para automatizar solicitudes a chat.com.

Análisis e Implicaciones

Este entorno implica una democratización del acceso a capacidades avanzadas de IA, permitiendo a los desarrolladores combinar inteligencia especializada para fases críticas del ciclo de vida del software. Al delegar tareas a agentes con fortalezas complementarias, se optimiza la eficiencia, se eleva la calidad del código, y se refuerza la seguridad y la robustez de los sistemas.

Contexto Adicional

El proyecto enfatiza la colaboración mediante un archivo shared.md en .agent-collab/context/ para proporcionar un contexto de proyecto unificado a ambos agentes, y está licenciado bajo MIT, promoviendo la adaptabilidad y uso comunitario.

Contenido

Dual Agent Development Environment

A collaborative development environment that pairs Claude Code (Anthropic) with Codex CLI (OpenAI) and ChatGPT Pro (GPT-5.2 Pro), enabling you to leverage the strengths of multiple AI models.

Why Multiple Agents?

Claude Code (Primary)	Codex CLI	ChatGPT Pro (GPT-5.2)
Fast iteration & prototyping	Deep, thorough code review	Extended thinking for complex analysis
Planning & orchestration	Complex algorithm implementation	200k context for large codebases
Quick fixes & refactoring	Security vulnerability analysis	Second opinion on architecture
Context switching & multitasking	Meticulous edge case handling	Long-running deep reviews (5-30 min)

By combining multiple models, you get rapid development velocity with rigorous quality checks and diverse perspectives.

Prerequisites

tmux - Terminal multiplexer
Claude Code - Anthropic's CLI
Codex CLI - OpenAI's CLI
jq - JSON processor
Node.js - For the MCP server

# macOS
brew install tmux jq node

# Claude Code & Codex CLI - follow their respective installation guides

Installation

git clone https://github.com/antorsae/dual-agent.git
cd dual-agent
./setup-dual-agent.sh

This will:

Build the codex-delegate MCP server
Install Claude skills to ~/.claude/skills/
Install Codex skills to ~/.codex/skills/
Configure Claude Code with MCP server and permissions
Initialize the .agent-collab/ directory

Three Ways to Use

Option 1: MCP Tools (Recommended)

After running setup, Claude Code has Codex tools available directly. Just ask naturally:

You: Review src/auth.ts for security vulnerabilities using codex

You: Have codex implement a rate limiter for the API

You: Ask codex to review my migration plan

Available MCP Tools:

Tool	Description
`delegate_codex_review`	Code review (security, bugs, performance)
`delegate_codex_implement`	Implement features with Codex
`delegate_codex_plan_review`	Review implementation plans
`delegate_codex`	Send any custom prompt to Codex

Option 2: Tmux Dual-Pane

For interactive side-by-side work with both agents visible:

This opens a split tmux session with Claude (left) and Codex (right).

Skills:

Claude Skills	Codex Skills
`/codex-review`	`$read-task`
`/codex-implement`	`$respond`
`/codex-plan-review`	`$claude-status`
`/codex-read`
`/codex-status`

Option 3: ChatGPT Code Review (Chrome)

Use GPT-5.2 Pro via Claude Code's Chrome integration for deep, extended-thinking code reviews:

# Start Claude Code with Chrome integration
claude --chrome

Then ask naturally:

You: Review src/auth.ts with ChatGPT

You: Get GPT-5.2 Pro to review this migration plan

Prerequisites:

Claude Code with --chrome flag
Claude in Chrome extension (v1.0.36+)
Logged into chat.com with ChatGPT Pro subscription

Workflow:

Claude submits the code review request to GPT-5.2 Pro
Returns immediately (non-blocking) - GPT-5.2 can take 5-30 minutes
Ask Claude to "fetch ChatGPT results" when ready

Skill: /chatgpt-code-review

Quick Start

MCP Tools (Simplest)

# 1. Run setup
./setup-dual-agent.sh

# 2. Restart Claude Code to load MCP tools
claude

# 3. Use naturally
> Review src/auth.ts for security issues using codex

Tmux Dual-Pane

# 1. Run setup
./setup-dual-agent.sh

# 2. Start dual-agent environment
./start-dual-agent.sh

# 3. In Claude pane, use skills
> /codex-review

Detailed Example: Security Review

Using MCP Tools

You: I just implemented authentication. Review src/auth.ts using codex
     for security vulnerabilities.

Claude: I'll use the delegate_codex_review tool to have Codex analyze this file...

[Claude calls delegate_codex_review tool]

Claude: Codex found the following issues:

## Critical Issues

1. **SQL Injection (Line 45)**
   The query uses string concatenation instead of parameterized queries.

   Fix:
   ```python
   cursor.execute("SELECT * FROM users WHERE id = ?", (user_id,))
   ```

2. **Weak Password Hashing (Line 78)**
   Using MD5 instead of bcrypt/argon2.

...

Using Tmux Dual-Pane

[Claude Pane]
You: Review src/auth.ts for security issues

Claude: I'll delegate this to Codex for a thorough security review.
        Delegating to Codex...

[Codex Pane - automatically receives task]
Codex: Reading task from Claude...
       Analyzing src/auth.ts for security vulnerabilities...
       [Deep analysis]
       Response ready.

[Claude Pane - automatically reads response]
Claude: Codex completed the review. Here are the findings:
        [Presents Codex's analysis]

Architecture

+-----------------------------------------------------------------------------------+
|                                    Claude Code                                    |
|                                                                                   |
|+-----------------------+  +-----------------------+  +---------------------------+|
||       MCP Tools       |  |     Skills (tmux)     |  |      Skills (Chrome)      ||
||   delegate_codex_*    |  |     /codex-review     |  |   /chatgpt-code-review    ||
|+-----------+-----------+  +-----------+-----------+  +-------------+-------------+|
+------------+--------------------------+----------------------------+--------------+
             |                          |                            |
             v                          v                            v
 +-----------------------+  +-----------------------+  +---------------------------+
 |    codex-delegate     |  |    .agent-collab/     |  |     Chrome + chat.com     |
 |      MCP Server       |  |   (file-based IPC)    |  |   (browser automation)    |
 |                       |  |                       |  |                           |
 |   Spawns codex CLI    |  |   requests/task.md    |  |   JavaScript injection    |
 +-----------+-----------+  +-----------+-----------+  +-------------+-------------+
             |                          |                            |
             v                          v                            v
 +-----------+--------------------------+-----------+  +-------------+-------------+
 |                    Codex CLI                     |  |        GPT-5.2 Pro        |
 |                                                  |  |                           |
 |        Deep code review & Implementation         |  | Extended thinking (5-30m) |
 |         Security analysis & Plan review          |  |  200k context + analysis  |
 +--------------------------------------------------+  +---------------------------+

Configuration

Shared Context

Edit .agent-collab/context/shared.md to provide both agents with project context:

# Shared Project Context

## Project Overview
E-commerce platform using FastAPI + Redis + PostgreSQL

## Architecture Decisions
- All auth uses JWT with refresh rotation
- Redis for rate limiting and session storage

## Conventions
- Type hints required on all functions
- Pydantic models for all API schemas

Claude Settings

The setup script configures ~/.claude/settings.json with:

{
  "mcpServers": {
    "codex-delegate": {
      "command": "node",
      "args": ["/path/to/dual-agent/agent/dist/mcp.js"]
    }
  },
  "permissions": {
    "allow": [
      "Bash(cat .agent-collab:*)",
      "Bash(tmux send-keys:*)",
      ...
    ]
  }
}

Tmux Key Bindings

Keys	Action
`Ctrl-b ←/→`	Switch between Claude and Codex panes
`Ctrl-b d`	Detach from session
`Ctrl-b z`	Zoom current pane (fullscreen toggle)

Troubleshooting

MCP tools not available

Check the setup completed successfully:

cat ~/.claude/settings.json | jq '.mcpServers'

Restart Claude Code:

Codex not receiving tasks (tmux mode)

Check tmux pane numbers: tmux list-panes
Ensure Codex is running in pane 1
Manually trigger: tmux send-keys -t 1 '$read-task' Enter

Status stuck (tmux mode)

echo "idle" > .agent-collab/status

Codex not working

# Verify codex is installed and authenticated
codex "hello"

Project Structure

dual-agent/
├── agent/                    # MCP server & CLI
│   ├── src/
│   │   ├── mcp.ts           # MCP server (delegate_codex_* tools)
│   │   ├── cli.ts           # CLI wrapper
│   │   └── codex.ts         # Codex subprocess spawner
│   └── dist/                # Compiled JS
├── .claude/skills/          # Claude Code skills
│   ├── codex-review/        # /codex-review (tmux mode)
│   ├── codex-implement/     # /codex-implement (tmux mode)
│   ├── codex-plan-review/   # /codex-plan-review (tmux mode)
│   ├── codex-read/          # /codex-read (tmux mode)
│   ├── codex-status/        # /codex-status (tmux mode)
│   └── chatgpt-code-review/ # /chatgpt-code-review (Chrome)
├── .codex/skills/           # Codex CLI skills
├── setup-dual-agent.sh      # Setup script
├── start-dual-agent.sh      # Tmux launcher
└── README.md

License

MIT

Fuente: GitHub