Beta Próximamente. Esta función aún está en desarrollo; los nombres y detalles pueden cambiar antes del lanzamiento.

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:

Local Changes con la fila de revisión encima del mensaje del commit: Review con el chip de modo Default, el icono de bicho de Find issues y Reviewed 2 files · 3 issues con el recuento por gravedad

ParteQué hace
✦ ReviewRevisa 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 bichoFind issues, la búsqueda de bugs más a fondo.
Último resultadoUna 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:

El bloque Agent review bajo Local Changes: el botón dividido Review, Find issues, los archivos cambiados y los hallazgosEl bloque Agent review bajo Local Changes: el botón dividido Review, Find issues, los archivos cambiados y los hallazgos
El bloque Agent review bajo Local Changes: el botón dividido Review, Find issues, los archivos cambiados y los hallazgos
ParteQué hace
Review ▾Revisa los cambios en el modo elegido. La flecha abre el menú de modos.
Find issuesUna búsqueda de errores más profunda que también lee los archivos cambiados completos.
Archivos cambiadosLos 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 estadoQué se revisó, en qué modo y con qué modelo, por ejemplo Review · Default: Staged changes (1 file) · 2 findings to look at · Ingot Fast.
HallazgosCada 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.

El bloque Agent review bajo los archivos cambiados en Local Changes, antes de una revisiónEl bloque Agent review bajo los archivos cambiados en Local Changes, antes de una revisión
El bloque Agent review bajo los archivos cambiados en Local Changes, antes de una revisión
El bloque Agent review bajo el resumen Edited 1 file de una ejecución del agente en el chatEl bloque Agent review bajo el resumen Edited 1 file de una ejecución del agente en el chat
El bloque Agent review bajo el resumen Edited 1 file de una ejecución del agente en el chat

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.

ModoQué revisa Review
DefaultErrores y cambios arriesgados: fallos, agujeros de seguridad, pérdida de datos, condiciones de carrera, lógica incorrecta, falta de manejo de errores.
My rulesLas 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 rulesListas 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.
BothLas 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.

El menú de modos de Review: Default, My rules, Industry rules y Both, con Default marcadoEl menú de modos de Review: Default, My rules, Industry rules y Both, con Default marcado
El menú de modos de Review: Default, My rules, Industry rules y Both, con Default marcado

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+/).

Un hallazgo de Find issues en el bloque Agent review, con las etiquetas Find issues y Bug, junto a los hallazgos de ReviewUn hallazgo de Find issues en el bloque Agent review, con las etiquetas Find issues y Bug, junto a los hallazgos de Review
Un hallazgo de Find issues en el bloque Agent review, con las etiquetas Find issues y Bug, junto a los hallazgos de Review

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 marcadoTodos 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 Security o Rule: 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ónQué hace
ApplyEscribe la corrección en el archivo y lo guarda. Deshacer funciona como siempre (⌘Z, Ctrl+Z).
Fix with agentAbre un chat que corrige el hallazgo con un cambio mínimo.
DismissOculta 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.

El visor de diferencias lado a lado: la lista de archivos, Change 1 of 2 y hallazgos bajo sus líneas con Apply y DismissEl visor de diferencias lado a lado: la lista de archivos, Change 1 of 2 y hallazgos bajo sus líneas con Apply y Dismiss
El visor de diferencias lado a lado: la lista de archivos, Change 1 of 2 y hallazgos bajo sus líneas con Apply y Dismiss
El visor de diferencias en modo unificado con los mismos hallazgos en líneaEl visor de diferencias en modo unificado con los mismos hallazgos en línea
El visor de diferencias en modo unificado con los mismos hallazgos en línea

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: …
Hallazgos de Agent review en las líneas cambiadas: uno rojo que bloquea y un aviso ámbar, con pistas en líneaHallazgos de Agent review en las líneas cambiadas: uno rojo que bloquea y un aviso ámbar, con pistas en línea
Hallazgos de Agent review en las líneas cambiadas: uno rojo que bloquea y un aviso ámbar, con pistas en línea

Bloquear o avisar ante hallazgos graves

Los hallazgos Critical y High son de gravedad alta. Lo que hacen depende de ingot.review.highSeverity:

ValorQué 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.
warnTodos 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.

Un commit bloqueado por Agent review, con Commit anywayUn commit bloqueado por Agent review, con Commit anyway
Un commit bloqueado por Agent review, con Commit anyway

Revisar al hacer clic o antes de cada commit

ingot.review.beforeCommit decide cuándo se ejecuta una revisión:

ValorComportamiento
offSin 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.
autoAdemá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ónmacOSWindows y Linux
Agent Review Before Commit⌘⌥⇧EnterCtrl+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 visorF7 / ⇧F7F7 / 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:

AjustePor defectoQué hace
ingot.review.beforeCommitonClickoff, onClick o auto
ingot.review.compactPaneltruetrue muestra Agent review como una fila; false muestra el bloque completo
ingot.agentReview.modedefaultdefault, rules, industry o both. Lo escribe el menú de Review.
ingot.review.highSeverityblockblock o warn
ingot.review.modelvacíoModelo 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/**"]
}
Settings › Tools › Agent review before commitSettings › Tools › Agent review before commit
Settings › Tools › Agent review before commit

Reglas de revisión

Cada revisión, en cualquier modo, sigue también esto, en este orden:

  1. Las reglas de tu equipo y los archivos BUGBOT.md, como en la revisión de código con IA.
  2. Cada entrada de ingot.review.rules. Una entrada que es una sola ruta .md, .mdc o .txt (@docs/review.md, ./review.txt) se lee del proyecto; cualquier otra cosa se usa como el texto de la regla.
  3. Cada archivo .md, .mdc y .txt de .ingot/review/ (hasta 40). Se quita el frontmatter, así que las reglas .mdc funcionan 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ónQué hace
--staged, --allRevisa 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-issuesLa 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, --ignoreReglas 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
--applyEscribe las correcciones sugeridas (no se preparan)
--mockUn 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.

Para revisar una rama entera o un pull request de GitHub en lugar del próximo commit, usa la revisión de código con IA.