Revisión del agente antes del commit
El bloque Agent review bajo tus archivos cambiados los revisa en el modo que elijas, busca problemas y te deja corregir cada hallazgo en línea antes del commit.
Está en la vista de control de código fuente y al final de cada ejecución del agente en el chat. Cada hallazgo trae su archivo y línea, una gravedad, si bloquea el commit y una corrección sugerida que puedes aplicar con un clic.
La fila de revisión
Por defecto, Agent review es una sola fila encima del mensaje del commit, en Local Changes, en la ventana Commit y bajo las ediciones de una ejecución del agente en el chat:

| Parte | Qué hace |
|---|---|
| ✦ Review | Revisa los cambios en el modo seleccionado. |
| Default ▾ | El chip de modo. Haz clic en él, o ejecuta Agent Review: Choose Review Mode (⌘⌥⇧., Ctrl+Alt+Shift+.), para elegir Default, My rules, Industry rules o Both. |
| Icono de bicho | Find issues, la búsqueda de bugs más a fondo. |
| Último resultado | Una línea como Reviewed 3 files · 1 issue con el recuento por gravedad. Haz clic para abrir los hallazgos en el visor de diferencias, con Apply y Dismiss bajo cada línea. |
| × | Borra el resultado. |
Un commit bloqueado muestra Commit blocked by Agent review · Commit anyway en la misma fila. Las explicaciones pasaron a los tooltips, y el editor sigue mostrando cada hallazgo en línea con sus correcciones rápidas.
Para ver el bloque completo de abajo, con la lista de archivos y cada hallazgo en línea, desactiva la fila compacta en Settings › Tools › Agent review before commit o en Settings › Features › Compact Agent review row (ingot.review.compactPanel).
El bloque Agent review
Con la fila compacta desactivada, un solo bloque lo reúne todo:


| Parte | Qué hace |
|---|---|
| Review ▾ | Revisa los cambios en el modo elegido. La flecha abre el menú de modos. |
| Find issues | Una búsqueda de errores más profunda que también lee los archivos cambiados completos. |
| Archivos cambiados | Los archivos que cubre la revisión, con el número de hallazgos abiertos. Haz doble clic en un archivo para abrir el visor de diferencias. |
| Líneas de estado | Qué se revisó, en qué modo y con qué modelo, por ejemplo Review · Default: Staged changes (1 file) · 2 findings to look at · Ingot Fast. |
| Hallazgos | Cada hallazgo con Apply, Fix with agent y Dismiss. |
El bloque aparece en dos sitios:
- Control de código fuente: en la ventana Local Changes (⌘K, Ctrl+K) y en la ventana Commit, bajo los archivos cambiados. Revisa lo que vas a confirmar.
- Chat: al final del resumen de ediciones de cada ejecución del agente, bajo Edited N files. Revisa solo las ediciones de esa ejecución.
En el control de código fuente el bloque aparece solo cuando Git funciona en la carpeta. En una carpeta sin repositorio, Local Changes y la ventana Commit muestran Initialize Repository en su lugar. Consulta Carpetas sin Git.




Modos de revisión
Haz clic en la flecha junto a Review para elegir qué revisa. Al principio está seleccionado Default, y se recuerda tu última elección.
| Modo | Qué revisa Review |
|---|---|
| Default | Errores y cambios arriesgados: fallos, agujeros de seguridad, pérdida de datos, condiciones de carrera, lógica incorrecta, falta de manejo de errores. |
| My rules | Las reglas de tu proyecto que se aplican a los archivos cambiados: .ingot/rules, .cursor/rules y AGENTS.md, incluidas las anidadas. Cada infracción se etiqueta con su regla, como Rule: engineering.mdc. Los errores graves se siguen informando. |
| Industry rules | Listas de comprobación integradas: Security, Performance, Accessibility (solo cuando cambia un archivo de interfaz, como .tsx, .html o .css) y Best practice. Cada infracción se etiqueta con su lista. |
| Both | Las reglas de tu proyecto más las listas de la industria. |
El botón muestra el modo actual (Review · Default) y la línea de estado indica cuántas reglas del proyecto se usaron. La elección se guarda en ingot.agentReview.mode, en tus ajustes de usuario, o en los del proyecto cuando el proyecto ya lo define.


Find issues
Find issues va más allá que Review. Busca errores concretos que el cambio introduce o deja al descubierto y da al modelo el texto actual completo de cada archivo cambiado, para que revise llamadas, invariantes, rutas de error, casos límite (vacío, nulo, cero, entradas grandes), errores de uno, carreras asíncronas y fugas de recursos.
Sus hallazgos llevan la etiqueta Find issues y la categoría Bug, y se suman a los de Review en la misma lista, en el editor y en el visor de diferencias. Cuentan para el bloqueo del commit como cualquier otro hallazgo. Ejecútalo desde el bloque, desde el visor de diferencias o con Agent Review: Find Issues (⌘⌥⇧/, Ctrl+Alt+Shift+/).


Revisa lo que vas a confirmar
En el control de código fuente, Review y Find issues cubren:
| Qué está preparado (staged) | Qué se revisa |
|---|---|
| Hay archivos marcados (staged) | Solo los archivos preparados |
| No hay nada marcado | Todos los cambios, incluidos los archivos nuevos |
También puedes ejecutar Git: Agent Review Before Commit (⌘⌥⇧Enter, Ctrl+Alt+Shift+Enter) o buscarlo con Find Action.
La revisión usa el mismo motor que la revisión de código con IA. Solo mira las líneas añadidas y cambiadas e informa de problemas reales.
Revisa las ediciones de una ejecución del agente
En el chat, el bloque bajo una ejecución del agente revisa solo los archivos que editó esa ejecución, comparados con cómo estaban antes, incluso antes de aceptar las ediciones. La línea de estado dice Agent edits (2 files). Apply, Dismiss y el visor de diferencias funcionan igual que en el control de código fuente.
Hallazgos y correcciones
Cada hallazgo muestra:
- su gravedad (Critical, High, Medium o Low)
- si Blocks commit (bloquea el commit) o es solo un Warning (aviso); consulta la sección sobre bloquear o avisar más abajo
- su categoría, como
SecurityoRule: engineering.mdc, y la etiqueta Find issues cuando lo encontró Find issues - su ubicación,
src/math.ts:2, que abre el archivo en esa línea - un título y por qué es un problema
- la corrección sugerida como un pequeño diff, cuando el modelo tiene una segura
Debajo de cada hallazgo:
| Acción | Qué hace |
|---|---|
| Apply | Escribe la corrección en el archivo y lo guarda. Deshacer funciona como siempre (⌘Z, Ctrl+Z). |
| Fix with agent | Abre un chat que corrige el hallazgo con un cambio mínimo. |
| Dismiss | Oculta el hallazgo. |
Apply busca el código por su texto, no por el número de línea. Si el código cambió desde la revisión, no se escribe nada y ves: The code changed since the review, so this fix no longer matches. Run Agent review again.
Visor de diferencias
Haz doble clic en un archivo del bloque (o pulsa Enter sobre él) para abrir un visor de diferencias grande, como el diálogo de commit de un IDE de escritorio:
- Side-by-side (lado a lado) o Unified (unificado), en la cabecera
- cambio anterior y siguiente (↑ ↓, o Shift+F7 y F7). Tras el último cambio de un archivo pasa al siguiente archivo, y la cabecera cuenta
Change 1 of 2. - los archivos cambiados a un lado: haz clic en uno para saltar a él
- Review (con el menú de modos) y Find issues en la cabecera
Mientras el visor está abierto, los hallazgos de Review y Find issues aparecen justo debajo de sus líneas con Apply y Dismiss, y se actualizan en vivo al revisar de nuevo, aplicar o descartar. Esc cierra el visor y devuelve el foco a donde estabas.




En el editor
Los hallazgos también aparecen en el editor y en los editores de diferencias:
- un icono en el margen y la línea resaltada, en rojo cuando el hallazgo bloquea el commit y en ámbar cuando solo avisa
- una pista corta al final de la línea, como
Blocks commit · High: sub subtracts in the wrong order - un hover con la explicación, la categoría y la corrección sugerida
- una entrada en Problems con el origen
Ingot Agent Review - acciones de contexto (⌥Enter, Alt+Enter): Apply fix: … y Fix with agent: …


Bloquear o avisar ante hallazgos graves
Los hallazgos Critical y High son de gravedad alta. Lo que hacen depende de ingot.review.highSeverity:
| Valor | Qué pasa al hacer commit |
|---|---|
block (por defecto) | El hallazgo dice Blocks commit y el commit se detiene con Commit blocked by Agent review: 1 high-severity finding. Apply or dismiss it, or Commit anyway. |
warn | Todos los hallazgos dicen Warning. El commit sigue adelante, con una notificación que lista los hallazgos. |
Commit anyway confirma enseguida. Aplicar o descartar el último hallazgo grave levanta el bloqueo. Los hallazgos Medium y Low nunca detienen un commit.


Revisar al hacer clic o antes de cada commit
ingot.review.beforeCommit decide cuándo se ejecuta una revisión:
| Valor | Comportamiento |
|---|---|
off | Sin bloque Agent review y sin revisión. |
onClick (por defecto) | Revisa cuando haces clic en Review o Find issues. Un hallazgo bloqueante detiene el commit hasta que lo apliques, lo descartes o lo ignores. |
auto | Además revisa antes de cada Commit y Commit and Push, en el modo elegido. Si los cambios son los mismos que en la última revisión, no se vuelve a ejecutar. |
En modo auto, si la revisión no puede ejecutarse (por ejemplo, el modelo no está disponible), el commit sigue adelante con un aviso: Agent review did not run (…). Committing without it.
Atajos de teclado
Todas las acciones están también en Find Action (⌘⇧A, Ctrl+Shift+A).
| Acción | macOS | Windows y Linux |
|---|---|---|
| Agent Review Before Commit | ⌘⌥⇧Enter | Ctrl+Alt+Shift+Enter |
| Agent Review: Find Issues | ⌘⌥⇧/ | Ctrl+Alt+Shift+/ |
| Agent Review: Choose Review Mode | ⌘⌥⇧. | Ctrl+Alt+Shift+. |
| Agent Review: Open Changes in Diff Viewer | ⌘⌥⇧, | Ctrl+Alt+Shift+, |
| Cambio siguiente / anterior en el visor | F7 / ⇧F7 | F7 / Shift+F7 |
Ajustes
Abre Settings › Tools › Agent review before commit, o define las claves en tus ajustes de usuario o en el .ingot/settings.json del proyecto:
| Ajuste | Por defecto | Qué hace |
|---|---|---|
ingot.review.beforeCommit | onClick | off, onClick o auto |
ingot.review.compactPanel | true | true muestra Agent review como una fila; false muestra el bloque completo |
ingot.agentReview.mode | default | default, rules, industry o both. Lo escribe el menú de Review. |
ingot.review.highSeverity | block | block o warn |
ingot.review.model | vacío | Modelo de la revisión. Vacío usa el modelo de revisión de ingot.agent.reviewModel y, si no, un modelo barato conectado como Ingot Fast. |
ingot.review.rules | [] | Reglas de revisión, una por línea: el texto de la regla o un archivo como @docs/review.md |
ingot.review.ignore | [] | Globs de rutas que se dejan fuera, uno por línea, como dist/** |
{
"ingot.review.beforeCommit": "auto",
"ingot.agentReview.mode": "both",
"ingot.review.highSeverity": "block",
"ingot.review.rules": ["Money is always integer cents.", "@docs/review-guidelines.md"],
"ingot.review.ignore": ["dist/**", "**/*.lock", "src/generated/**"]
}


Reglas de revisión
Cada revisión, en cualquier modo, sigue también esto, en este orden:
- Las reglas de tu equipo y los archivos
BUGBOT.md, como en la revisión de código con IA. - Cada entrada de
ingot.review.rules. Una entrada que es una sola ruta.md,.mdco.txt(@docs/review.md,./review.txt) se lee del proyecto; cualquier otra cosa se usa como el texto de la regla. - Cada archivo
.md,.mdcy.txtde.ingot/review/(hasta 40). Se quita el frontmatter, así que las reglas.mdcfuncionan tal cual.
Un archivo de .ingot/review/ al que ya enlaza un BUGBOT.md no se añade dos veces. Como en Bugbot, cada regla se corta a 30.000 caracteres y todas las reglas de una revisión suman como mucho 100.000. El modo My rules añade las reglas de tu proyecto dentro de los mismos límites.
Rutas ignoradas
Los archivos que coinciden con ingot.review.ignore nunca se envían al modelo. Igualmente se incluyen en el commit. La línea de estado los cuenta: 1 file ignored.
Presupuesto
Una revisión es rápida y barata: como mucho 3 llamadas al modelo de 24.000 caracteres de diff cada una, y hasta 40 hallazgos. Find issues también envía el texto de los archivos cambiados, hasta 12.000 caracteres por archivo y 24.000 por llamada. Los archivos que no caben aparecen en la línea de estado como fuera del presupuesto de revisión.
Desde la terminal
La CLI ingot ejecuta la misma revisión, así que puedes usarla en un hook de git o en CI:
ingot review # cambios preparados; si no hay, todos los cambios
ingot review --mode both # reglas del proyecto y listas de la industria
ingot review --find-issues # búsqueda de errores más profunda con los archivos completos
ingot review --all --json # todo, en JSON
ingot review --apply # escribe las correcciones sugeridas en los archivos
ingot review --fail-on medium # falla también con hallazgos medium
Lee ingot.review.rules, ingot.review.ignore, ingot.review.highSeverity e ingot.agentReview.mode de .ingot/settings.json, las reglas de .ingot/review/ y tus archivos BUGBOT.md. Sale con 1 cuando un hallazgo grave bloquea el commit, así que un hook pre-commit es una línea:
# .git/hooks/pre-commit
ingot review --staged
| Opción | Qué hace |
|---|---|
--staged, --all | Revisa solo los cambios preparados, o todos los cambios |
--mode <modo> | default, rules, industry o both (por defecto: ingot.agentReview.mode y, si no, default) |
--find-issues | La búsqueda de errores de Find issues en lugar de una revisión en un modo |
--model <id> | Modelo de OpenRouter (por defecto google/gemini-2.5-flash-lite) |
--max-cost <usd> | Tope de coste estricto para toda la revisión (por defecto $0.05, como mucho $1). Una llamada que podría superarlo no se hace y la ejecución sale con 3. |
--rule, --ignore | Reglas y globs ignorados extra; repítelos para añadir más |
--warn, --fail-on <gravedad> | Informa sin fallar, o falla a partir de una gravedad |
--apply | Escribe las correcciones sugeridas (no se preparan) |
--mock | Un revisor gratuito y determinista para probar pipelines |
La clave de OpenRouter sale de OPENROUTER_API_KEY o de ai.openrouterApiKey en el ingot.config.json del proyecto, que está en gitignore. Consulta la referencia de la CLI.