Bugbot

Bugbot revisa pull requests e identifica errores, vulnerabilidades de seguridad y problemas de calidad del código.

Configura Bugbot en Automatizaciones.

Cómo funciona

Bugbot analiza los diffs de las PR y deja comentarios con explicaciones y sugerencias de solución. Se ejecuta automáticamente con cada actualización de la PR o manualmente al activarlo.

• Ejecuta revisiones automáticas con cada actualización de la PR
• Activación manual al comentar cursor review o bugbot run en cualquier PR
• Usa los comentarios existentes de la PR como contexto: lee los comentarios de la PR vinculados (de nivel superior y en línea) para evitar sugerencias duplicadas y aprovechar comentarios anteriores
• Los enlaces de Fix in Cursor abren los problemas directamente en Cursor
• Los enlaces de Fix in Web abren los problemas directamente en cursor.com/agents

Configuración

Conecta tus repositorios desde el panel de control de Cursor para empezar a usar Bugbot.

• GitHub (incluido GitHub Enterprise Server): Consulta la página de integración de GitHub
• GitLab (incluido GitLab Self-Hosted): Consulta la página de integración con GitLab
• Bitbucket (incluido Bitbucket Data Center): Consulta la página de integración de Bitbucket

Una vez conectados, abre Bugbot en Automatizaciones para activarlo en repositorios específicos.

Estados de las comprobaciones de CI

Bugbot publica un estado para cada ejecución de revisión. En GitHub, aparece como una comprobación llamada Cursor Bugbot. En Bitbucket, aparece como un estado de compilación con la clave cursor-bugbot. El estado puede tener una de estas conclusiones:

• success: Bugbot no encontró problemas y no hay comentarios de Bugbot sin resolver de ejecuciones anteriores.
• neutral: Bugbot encontró problemas, la ejecución fue cancelada por un commit más reciente o Bugbot sufrió un error interno. Esta es la conclusión predeterminada cuando Bugbot informa hallazgos.
• failure: Bugbot encontró problemas y la comprobación está configurada para fallar cuando hay problemas sin resolver.

Si usas protección de ramas, exige la comprobación o el estado de compilación de Bugbot para asegurarte de que Bugbot se ejecute antes de fusionar. Exigir solo el estado no bloquea las fusiones por hallazgos, ya que estos usan neutral de forma predeterminada. Si el comportamiento de fallar por problemas sin resolver está disponible para tu organización, actívalo para que los hallazgos sin resolver generen un estado fallido. Bugbot no emite la conclusión skipped.

Cuando Bugbot Autofix está activado, GitHub también puede mostrar una comprobación independiente de Cursor Bugbot Autofix. Esa comprobación solo usa success o neutral.

Configuración

Analítica

Abre Bugbot en Automatizaciones para consultar la actividad de revisión y los resultados.

API

Los equipos Enterprise pueden usar la API de Bugbot para iniciar revisiones y consultar analítica por revisión. Cree una clave de API en Cursor Panel de control → API Keys y autentíquese con Basic Authentication.

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42"  }'

curl --request POST \  --url https://api.cursor.com/bugbot/review \  -u YOUR_API_KEY: \  --header 'Content-Type: application/json' \  --data '{    "prUrl": "https://github.com/your-org/your-repo/pull/42",    "dryRun": true  }'

{  "outcome": "success",  "message": "Bugbot review queued",  "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",  "dry_run": false}

{  "outcome": "error",  "message": "Bugbot is disabled for this repository"}

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'startDate=2026-06-01' \  --data-urlencode 'endDate=2026-06-29' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42' \  --data-urlencode 'page=1' \  --data-urlencode 'pageSize=100'

curl --get https://api.cursor.com/analytics/team/bugbot-reviews \  -u YOUR_API_KEY: \  --data-urlencode 'dryRun=true' \  --data-urlencode 'repo=github.com/your-org/your-repo' \  --data-urlencode 'prNumber=42'

{  "data": [    {      "request_id": "6e0d261c-86a2-4383-89f0-9162c1c10662",      "timestamp": "2026-06-29T19:42:18.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 2,      "cost_cents": 42.5,      "dry_run": false,      "publication_status": "posted",      "bugs": [        {          "comment_id": "2147483999",          "resolution_status": "resolved",          "severity": "high"        },        {          "comment_id": "2147484000",          "resolution_status": "unresolved",          "severity": "medium"        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "page": 1,    "pageSize": 100  }}

{  "data": [    {      "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",      "timestamp": "2026-06-29T20:15:03.000Z",      "repo": "github.com/your-org/your-repo",      "repo_node_id": "R_kgDOABCDEF",      "pr_number": 42,      "commit_sha": "9f3c2a1b7d8e4f5061728394a5b6c7d8e9f0a1b2",      "bugs_found": 1,      "cost_cents": null,      "dry_run": true,      "publication_status": "dry_run",      "bugs": [        {          "comment_id": null,          "resolution_status": null,          "severity": "medium",          "title": "Unbounded retry loop",          "description": "retry() recurses without a ceiling.",          "locations": [            { "file": "src/net.ts", "start_line": 5, "end_line": 9 }          ]        }      ]    }  ],  "pagination": {    "page": 1,    "pageSize": 100,    "totalItems": 1,    "totalPages": 1,    "hasNextPage": false,    "hasPreviousPage": false  },  "params": {    "metric": "bugbot-reviews",    "teamId": 12345,    "startDate": "2026-06-01",    "endDate": "2026-06-29",    "repo": "github.com/your-org/your-repo",    "prNumber": 42,    "dryRun": true,    "page": 1,    "pageSize": 100  }}

Iniciar y recuperar una revisión

1. Llame a POST /bugbot/review con la URL de la pull request. Pase "dryRun": true para analizar sin publicar en el SCM.
2. Guarde el request_id devuelto.
3. Consulte GET /analytics/team/bugbot-reviews y filtre por repo y prNumber. Use dryRun=true si inició una revisión en modo dry run.
4. Busque el elemento cuyo request_id coincida con el de la respuesta de inicio.

La analítica puede tardar un poco en estar disponible después de poner una revisión en cola.

Revisiones incrementales

De forma predeterminada, Bugbot revisa el diff completo de la pull request con cada push. Activa Revisión incremental en Bugbot automatización para revisar solo los cambios desde la revisión anterior de Bugbot.

Niveles de esfuerzo

Los niveles de esfuerzo controlan cuánto tiempo dedica Bugbot a razonar durante una revisión. Los niveles de esfuerzo más altos pueden detectar más errores, pero cada revisión puede tardar más y consumir más.

Elige uno de estos niveles de esfuerzo:

• Predeterminado: Optimiza la eficiencia y la velocidad. Las revisiones son menos costosas, pero Bugbot puede detectar menos errores.
• Alto: Dedica más tiempo a razonar. Las revisiones son más costosas y tardan más, pero Bugbot puede detectar más errores.
• Personalizado: Te permite indicar cuándo Bugbot debe usar revisiones más largas y exhaustivas. Cursor establece dinámicamente los niveles de esfuerzo según tus instrucciones.

Reglas

Guía las revisiones mediante reglas del equipo, reglas del repositorio y archivos .cursor/BUGBOT.md del proyecto.

Reglas del equipo

Los administradores de equipo pueden crear reglas en Bugbot automatización que se aplican a todos los repositorios del equipo. Estas reglas están disponibles para todos los repositorios activados, lo que facilita la aplicación de estándares en toda la organización.

Límites de las reglas

Cada regla se trunca a 30.000 caracteres al incluirse en una revisión. El total de reglas que Bugbot incluye en una revisión está limitado a 100.000 caracteres. Si superas ese límite, es posible que se omitan algunas reglas. Las reglas del equipo obligatorias tienen prioridad sobre las no obligatorias.

Consulta qué reglas utilizó una revisión

Añade el comentario bugbot run verbose=true o cursor review verbose=true en una solicitud de extracción. Bugbot publica una tabla con todas las reglas incluidas en esa ejecución e indica cuáles se truncaron u omitieron.

Reglas del repositorio

Reglas del proyecto

Crea archivos .cursor/BUGBOT.md para proporcionar contexto específico del proyecto durante las revisiones. Bugbot siempre incluye el archivo .cursor/BUGBOT.md de la raíz y cualquier archivo adicional que encuentre al recorrer hacia arriba desde los archivos modificados.

project/  .cursor/BUGBOT.md          # Siempre incluido (reglas de todo el proyecto)  backend/    .cursor/BUGBOT.md        # Se incluye al revisar archivos de backend    api/      .cursor/BUGBOT.md      # Se incluye al revisar archivos de API  frontend/    .cursor/BUGBOT.md        # Se incluye al revisar archivos de frontend

Reglas aprendidas

En las reglas de repositorio de Bugbot, activa el aprendizaje para tus organizaciones y repositorios.

Las reglas se generan automáticamente a partir de la actividad de tu equipo en GitHub para ese repositorio o mediante una carga retroactiva manual desde el historial del repositorio.

También puedes enseñarle nuevas reglas a Bugbot directamente comentando @cursor remember [fact] en cualquier PR. Bugbot guarda el hecho como una regla aprendida y la aplica en futuras revisiones.

Cursor activará o desactivará automáticamente las reglas a medida que vaya aprendiendo más sobre la actividad de tu equipo.

Reglas manuales

En Reglas de repositorio de Bugbot, puedes crear reglas manuales para repositorios individuales.

Analítica de reglas

La analítica de una regla de Bugbot muestra su rendimiento en PR reales:

Ejemplos

Si algún archivo modificado contiene el patrón de cadena /\beval\s*\(|\bexec\s*\(/i:- Añade un error bloqueante con el título "Ejecución dinámica peligrosa" y el cuerpo:  "Se detectó el uso de eval/exec. Sustitúyelo por alternativas seguras o justifícalo con un comentario detallado y pruebas."- Asigna el error al autor de la PR.- Aplica la etiqueta "security".

Si la PR modifica archivos de dependencias (package.json, pnpm-lock.yaml, yarn.lock, requirements.txt, go.mod, Cargo.toml):- Ejecuta el análisis de licencias integrado.- Si alguna dependencia nueva o actualizada tiene una licencia de {GPL-2.0, GPL-3.0, AGPL-3.0}:  - Añade un error bloqueante con el título "Se detectó una licencia no permitida"  - Incluye en el cuerpo del error los nombres, versiones y licencias de los paquetes infractores  - Aplica las etiquetas "compliance" y "security"

Para archivos que coincidan con **/*.{js,jsx,ts,tsx} en proyectos de React:Si un archivo modificado contiene /componentWillMount\s*\(/:- Añade un error bloqueante con el título "Método de ciclo de vida de React en desuso"- Cuerpo: "Sustituye componentWillMount por constructor o useEffect. Consulta la documentación de React."- Sugiere un fragmento de corrección automática que migre los efectos secundarios a useEffect.

Si la PR modifica archivos en {server/**, api/**, backend/**} y no hay cambios en {**/*.test.*, **/__tests__/**, tests/**}:- Añade un error bloqueante con el título "Faltan pruebas para los cambios de backend"- Cuerpo: "Esta PR modifica código de backend, pero no incluye pruebas correspondientes. Añade o actualiza las pruebas."- Aplica la etiqueta "quality"

Si algún archivo modificado contiene /(?:^|\s)(TODO|FIXME)(?:\s*:|\s+)/:- Añade un error no bloqueante con el título "Se encontró un comentario TODO/FIXME"- Cuerpo: "Sustituye TODO/FIXME por una referencia a un problema del que se haga seguimiento, p. ej., `TODO(#1234): ...`, o elimínalo."- Si el TODO ya hace referencia a un patrón de problema /#\d+|[A-Z]+-\d+/, marca el error como resuelto automáticamente.

Ejecuta desde tu agente

Usa las skills /review-bugbot o /review para ejecutar Bugbot desde tu agente antes de hacer push del código.

Qué diff se revisa: De forma predeterminada, /review-bugbot revisa los cambios de tu rama: todos los cambios con respecto a la rama base, incluidos los cambios con y sin commit. Pídele que revise solo los cambios sin commit si quieres comentarios más específicos.

Con qué rama se compara: /review-bugbot compara con tu rama base predeterminada. Si tu rama base no es la predeterminada (por ejemplo, main), indícale al agente con qué rama comparar o deja que lo infiera a partir del contexto.

Sincronización con tu pull request

Las revisiones de /review-bugbot se sincronizan con Bugbot en el SCM conectado (GitHub, GitLab o Bitbucket).

Internamente, /review-bugbot almacena el ID del parche del diff revisado. Cuando Bugbot en tu SCM detecta un diff con el mismo ID de parche, omite la revisión y deja un comentario indicando que ya había revisado ese diff.

Un caso de uso habitual: ejecuta /review-bugbot, abre un pull request con el mismo diff y Bugbot reconoce la revisión y omite la revisión remota de la PR.

Autofix

Bugbot Autofix inicia automáticamente un agente en la nube para corregir los errores detectados durante las revisiones de PR.

Cómo funciona

Cuando Bugbot detecta errores durante la revisión de un PR, puede automáticamente:

1. Iniciar un agente en la nube para analizar y solucionar los problemas detectados
2. Enviar las soluciones a la rama existente o a una nueva rama (según tus ajustes)
3. Publicar un comentario en el PR original con los resultados

Configuración

Configura el comportamiento de Autofix en Bugbot automatización.

Requisitos

Autofix requiere:

• Tener activados los precios de uso bajo demanda
• Tener activado el almacenamiento (no en el modo de privacidad heredado)

Facturación

Autofix usa créditos de agente en la nube y se cobra según las tarifas de tu plan. La facturación de agente en la nube sigue tu plan de precios.

Compatibilidad con MCP

Bugbot se integra con tus servidores MCP para que tus herramientas de IA puedan interactuar directamente con él. Usa el servidor MCP para añadir herramientas que orienten el proceso de revisión de Bugbot.

Para empezar:

1. Sigue las instrucciones de configuración del servidor en la documentación de MCP.
2. Añade las herramientas a Bugbot en Automatizaciones.

API de configuración para administradores

Los administradores de equipo pueden usar la API de Admin de Bugbot para gestionar repositorios y controlar qué usuarios pueden usar Bugbot. Úsala para automatizar la gestión de repositorios, activar Bugbot en varios repositorios o integrar el aprovisionamiento de usuarios con herramientas internas.

Autenticación

Todos los endpoints requieren una clave de API de administrador de equipo enviada como token Bearer:

Authorization: Bearer $API_KEY

Para crear una clave de API:

1. Ve a Claves de API en el panel de control de Cursor
2. Haz clic en Nueva clave de API
3. Guarda la clave de API

Todos los endpoints tienen un límite de 60 solicitudes por minuto por equipo.

Activar o desactivar repositorios

Usa el endpoint /bugbot/repo/update para activar o desactivar Bugbot en un repositorio:

curl -X POST https://api.cursor.com/bugbot/repo/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "repoUrl": "https://github.com/your-org/your-repo",    "enabled": true,    "manualTriggerOnly": false  }'

Parámetros:

• repoUrl (string, obligatorio): La URL completa del repositorio
• enabled (boolean, obligatorio): true para activar Bugbot; false para desactivarlo
• manualTriggerOnly (boolean, opcional): Si es true, Bugbot no se ejecutará automáticamente cuando se actualice una PR en este repositorio. Las activaciones manuales, como comentar cursor review o bugbot run, seguirán funcionando.

Listar repositorios

Usa el endpoint /bugbot/repos para listar todos los repositorios con la configuración de Bugbot de tu equipo:

curl https://api.cursor.com/bugbot/repos \  -H "Authorization: Bearer $API_KEY"

La respuesta incluye el estado de activación, la configuración de uso exclusivamente manual y las marcas de tiempo de cada repositorio.

Gestión del acceso de usuarios

Use el endpoint /bugbot/user/update para controlar qué usuarios de GitHub, GitLab o Bitbucket pueden usar las licencias de Bugbot de su equipo. Las empresas lo usan para integrar el aprovisionamiento de Bugbot con herramientas internas de solicitud de acceso.

Requisitos previos

Antes de llamar a este endpoint, activa el modo de lista de permitidos o de lista de bloqueados en la configuración de Bugbot de tu equipo:

• Modo de lista de permitidos ("Solo..."): Solo los usuarios de la lista pueden usar Bugbot
• Modo de lista de bloqueados ("Todos excepto..."): Todos los usuarios pueden usar Bugbot excepto los de la lista

Si ninguno de los dos modos está activado, la API devuelve un error.

Añadir o eliminar usuarios

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "username": "octocat",    "allow": true  }'

Parámetros:

• username (string, obligatorio): El nombre de usuario de GitHub, GitLab o Bitbucket (no distingue entre mayúsculas y minúsculas)
• allow (booleano, obligatorio): Indica si se concede o revoca el acceso

El comportamiento de allow depende del modo activo:

Respuesta:

{  "outcome": "success",  "message": "Updated team-level allowlist for @octocat",  "updatedTeamSettings": true,  "updatedInstallations": 0}

Ejemplo: aprovisionamiento de usuarios mediante una herramienta interna

Conecta esta API a un portal interno de solicitudes de acceso. Cuando un empleado solicita acceso a Bugbot, el portal llama a la API para añadirlo. Cuando deja la empresa o pierde el acceso, el portal llama a la API para eliminarlo.

Conceder acceso:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": true}'

Revocar el acceso:

curl -X POST https://api.cursor.com/bugbot/user/update \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{"username": "employee-scm-username", "allow": false}'

Precios

Bugbot utiliza facturación basada en consumo.

Facturación

Solución de problemas

Si Bugbot no funciona:

1. Activa el modo detallado comentando cursor review verbose=true o bugbot run verbose=true para obtener registros detallados, ver qué reglas de Bugbot se cargaron y un ID de solicitud
2. Comprueba los permisos para verificar que Bugbot tenga acceso al repositorio
3. Verifica la instalación para confirmar que la integración con tu proveedor de repositorios esté instalada y activada

Incluye el ID de solicitud del modo detallado al informar de problemas.

Preguntas frecuentes