17. Funciones avanzadas y extensiones

Objetivo del tema

Conocer prestaciones avanzadas de Codex: revisión de pull requests mediante @codex, automatización de workflows y uso experimental de imágenes como contexto.

17.1 Visor general

Codex CLI se integra con servicios externos y suma capacidades para escenarios colaborativos.

@codex en GitHub

Invoca al bot en una PR para obtener revisiones automáticas, resúmenes y sugerencias.

Workflows automatizados

Usa codex exec o la acción oficial para ejecutar pipelines repetibles.

Imágenes y diagramas

Adjunta capturas o esquemas para que el agente los interprete durante la sesión.

17.2 Revisión de PRs con @codex

El bot @codex en GitHub permite solicitar revisiones asincrónicas. Asegúrate de que la integración esté habilitada en tu repositorio.

@codex review

Contexto:
- Rama: feature/review-model
- Objetivo: validar que el nuevo flag `--review-model` funcione.

Pide comentarios sobre:
- Cambios en docs/config.md.
- Uso del nuevo campo en la TUI.

Codex analiza el diff, genera observaciones y puede redactar una descripción de PR. Algunas recomendaciones:

  • Incluye instrucciones breves y preguntas concretas.
  • Solicita un resumen de riesgos o TODOs pendientes para orientar la revisión humana.
  • Complementa con @codex summarize si deseas un TL;DR del cambio.
Nota: @codex hereda las cuotas de tu plan de ChatGPT. Si recibes un mensaje de límite, espera el reset o delega en otro revisor con cuota disponible.

17.3 Automatización de workflows

Codex CLI puede integrarse en pipelines CI/CD para tareas no interactivas:

codex exec --json --output-last-message resultado.json "npm run lint && npm test"

Esto genera un archivo JSON con el resumen final. Puedes subirlo como artefacto o comentarlo en una PR.

Otra opción es usar la GitHub Action oficial:

name: Codex Review
on:
  pull_request:
    branches: [main]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Codex review
        uses: openai/codex-action@v1
        with:
          prompt: |
            Revisa la PR y comenta riesgos.
          approval_policy: on-request
          sandbox_mode: workspace-write

El action ejecuta Codex en modo no interactivo y publica los comentarios resultantes. Ajusta variables de entorno para manejar API keys y permisos.

17.4 Uso experimental de imágenes o diagramas

Las versiones recientes permiten adjuntar imágenes o diagramas para enriquecer el contexto. Está disponible tanto en la TUI como mediante flags.

# En la TUI
# pega la imagen (Ctrl+V / Cmd+V) o arrástrala a la ventana.

# Vía CLI
codex --image arquitectura.png "Explica la relación entre microservicios"

# Modo no interactivo
codex exec --image monitoreo.png "Genera alertas sugeridas para este dashboard"

Consejos para obtener mejores resultados:

  • Usa formatos claros (PNG, JPG) y resalta áreas relevantes con anotaciones.
  • Combina la imagen con contexto textual («Los nodos azules son servicios HTTP»).
  • Si la funcionalidad está marcada como experimental, valida el resultado manualmente antes de tomar decisiones críticas.

17.5 Flujo combinado de revisión

Ejemplo paso a paso

  1. Codex CLI local: Ejecuta codex --full-auto "Refina la validación y ejecuta tests" para preparar el cambio.
  2. @codex en PR: Abre la pull request y menciona @codex review con preguntas específicas.
  3. Workflow automático: Usa la acción de GitHub para ejecutar codex exec y publicar resultados de tests.
  4. Imagen contextual: Adjunta un diagrama del flujo de eventos para que Codex valide la coherencia con el código.
  5. Revisión humana: Completa la revisión combinando los hallazgos automáticos con tus criterios.

17.6 Conclusión

Las funciones avanzadas de Codex potencian la colaboración: puedes automatizar revisiones, respaldar pipelines y enriquecer el contexto con imágenes. Experimenta con estas integraciones y define pautas en tu equipo para aprovecharlas con seguridad y trazabilidad.