Codexplain: el proyecto para hacer que Codex hable como Claude Code

Al usar Codex, me di cuenta de que corrige código muy bien, pero a veces sus explicaciones te dejan pensando: “¿y entonces qué quiso decir con esto?”.
En particular, había tres cosas que me incomodaban.

1. Explicaciones centradas en nombres de archivos o funciones
   • Codex a menudo explica por archivo, como README.md, rust/codexplain.rs o package.json, en lugar de enfocarse en “qué hace una función y cómo fluye”. Si ya conoces la estructura del proyecto está bien, pero en una base de código nueva muchas veces terminas teniendo que volver a preguntar.
2. Párrafos difíciles de leer en la terminal
   • Si diera explicaciones estructuradas como Claude Code, con TLDR, tablas, diagramas, paneles de riesgo y siguientes acciones, sería mucho más rápido de leer, pero las explicaciones de Codex suelen parecerse más a texto corrido.
3. La conclusión llega tarde y hay demasiada información innecesaria
   • Lo primero que el usuario quiere saber es “entonces, ¿qué necesito entender ahora?”, pero Codex a veces intenta soltar todo el contexto de una sola vez.

Por eso hice Codexplain.

Codexplain no es un modelo para reemplazar a Codex, sino una capa de UX de explicación que transforma localmente las respuestas de Codex para que sean más fáciles de leer dentro del proyecto.

Funciones principales:

• organiza las explicaciones en formato TLDR / resumen / tabla / diagrama de arquitectura / risk panel / next action
• conserva intactos los artifacts estrictos como JSON, code, diff, patch, log y test output
• permite ajustar explanation depth, architecture depth y abstraction level
• terminal-friendly semantic highlight
• configuración local del proyecto basada en codexplain/
• posibilidad de agregar custom explanation styles para equipos o preferencias personales
• activación/desactivación local y desinstalación posibles

Instalación:

npm install -g codexplain
codexplain install-codex --local --force

Si al usar Codex has sentido que “el código está bien, pero la explicación es demasiado poco amigable”, pruébalo y comparte en un issue lo que te falte o el estilo de explicación que te gustaría ver. ¡Las estrellas siempre son bienvenidas! ⭐️