Agent Bridge

Codex supervisa a Claude Code y DeepSeek Harness. Bridge no llama a LLM por sí mismo.

Deja que Codex sea el único supervisor. Claude Code o DeepSeek Harness se encargan de la implementación. Tú revisas, verificas y aplicas en Codex.

Un solo comando

npx -y codex-agent-bridge

Luego inicia una nueva ronda de Codex. Verás las herramientas bridge_*.

Este comando: instala el runtime en ~/.agent-bridge, escribe el Skill de Codex y el MCP (usando node.exe local, no npx.cmd), y ejecuta doctor una vez.

Para actualizar, vuelve a ejecutar el mismo comando. Para desinstalar:

npx -y codex-agent-bridge uninstall
npx -y codex-agent-bridge uninstall --purge

--purge eliminará ~/.agent-bridge.

Requisitos previos

Lo que no hacemos

• No instalamos Claude Code / DeepSeek Harness por ti

• No modificamos su model / provider / reasoning effort

• No llamamos a ningún LLM

Con qué Worker cuentes, ese se usará. Si no hay ninguno, doctor lo indicará.

Related MCP server: cc-agent

Qué hace

Codex  ──bridge_run──►  Claude Code / DeepSeek Harness
  ▲                         │
  │      ReviewPacket       │  在独立 worktree 里改代码
  │      verification       │  不得 commit / push / merge
  └──── bridge_apply ◄──────┘

Ciclo cerrado:

bridge_run
→ WAITING_FOR_INPUT 时 bridge_respond
→ AWAITING_REVIEW + ReviewPacket
→ bridge_approve     任务分支 checkpoint，不是完成发布
→ bridge_apply       cherry-pick 到当前分支，不是 merge

Fin de Turn ≠ tarea completada. Diff solo reconoce baseCommit vs worktree.

bridge_run solo elige worker: claude o deepseek (en depuración se puede usar replay / fake). No pases model / provider / effort.

Si DeepSeek Harness no está en una ruta común, configura AGENT_BRIDGE_DEEPSEEK_ROOT.

Notas de uso

• El objetivo debe ser un repositorio git independiente. Cada bridge_* lleva el mismo project. El nombre del campo UUID de la tarea es task.

• Solo puede haber un Writer a la vez para el mismo proyecto. Un segundo escritor devuelve CORE_LOCK_HELD.

• Si modificas el MCP, debes reiniciar Codex; la sesión anterior no verá las nuevas herramientas.

• Un tasks.json dañado generará TASK_STORE_CORRUPTED, no se tratará como un almacén vacío.

Publicar una nueva versión

npm publish local siempre pedirá 2FA, es una regla de npm y no se puede hacer que funcione sin contraseña como git push.

La forma correcta es: cambiar versión → crear tag → hacer push, GitHub Actions usa Trusted Publishing para publicar en npm, sin necesidad de ingresar contraseña.

Configuración única (solo una vez): abre la configuración de npm de codex-agent-bridge → Trusted Publisher → GitHub Actions, completa:

A partir de entonces, cada vez:

# 先改 package.json 里的 version，提交
git tag v1.2.0
git push origin main --tags

Desarrollo desde el código fuente

npm install
npx tsx src/cli.ts setup --dev
npm test

--dev hace que el MCP apunte al repositorio actual, no a ~/.agent-bridge.

Documentación

El directorio del repositorio puede seguir llamándose Agent Relay. El nombre del producto es Agent Bridge. El paquete npm es codex-agent-bridge.