Referencia de comandos · Codex CLI
codex review
Realiza una revisión de cambios a través de la CLI.
codex review ejecuta una revisión de código de forma no interactiva desde la línea de comandos, es decir, sin que se abra una sesión TUI en curso.
Según la documentación, eliges exactamente un objetivo de revisión: --uncommitted (cambios staged, unstaged y untracked), --base <branch> (diff contra una rama base), --commit <SHA> (cambios de un commit concreto), o instrucciones de revisión propias como PROMPT en texto libre (también legible desde stdin con -) — según la documentación, estas opciones se excluyen mutuamente. --title establece el título de commit mostrado en el resumen de la revisión, pero solo funciona junto con --commit. Además existe --strict-config, que provoca un error si config.toml contiene campos desconocidos. Hay que distinguir la llamada independiente codex review del comando slash /review, que según el código fuente de Codex se usa dentro de una sesión interactiva ya en curso y allí también acepta instrucciones como argumento en línea.
✅ ¿CUÁNDO USARLO?
Revisar cambios sin confirmar antes del commit
codex review --uncommitted
Revisar un commit concreto con título
codex review --commit a1b2c3d --title "Fix Login-Bug"
⛔ ¿CUÁNDO MEJOR NO?
Especificar varios objetivos de revisión a la vez
según la documentación, --uncommitted, --base, --commit y un PROMPT propio se excluyen mutuamente — solo se permite una opción.
Mejor: elegir exactamente una opción de objetivo, por ejemplo solo --base main
La revisión debe formar parte de una sesión interactiva en curso
codex review es una llamada de CLI independiente y no interactiva, fuera de una sesión TUI en curso.
Mejor: dentro de una sesión en curso, usar en su lugar /review
FUENTES
- documentación de Codex CLI: Reference ↗ learn.chatgpt.com
MÁS COMANDOS · Codex CLI