Reportes de bugs en GitHub Issues con la grabación de pantalla y los logs de consola y de red
Actualizado
GitHub Issues es donde muchos equipos de producto y proyectos de código abierto siguen sus bugs, justo al lado del código. Midge permite que cualquiera del equipo grabe un bug con sus logs de consola, sus peticiones de red y los datos del dispositivo, y después haga clic en Send to GitHub para abrir un issue con el resumen escrito por IA, los pasos para reproducir, la causa probable y un enlace a la grabación.
Cómo funciona
- Instala la app una vez. Un admin del espacio de trabajo abre Settings › Workspace › Integrations en Midge y hace clic en Connect en GitHub. GitHub le pide que instale la app Midge Bug Reports y que elija los repositorios en los que puede abrir issues. Midge comprueba con su inicio de sesión de GitHub que la instalación es suya antes de guardarla, y después elige el repositorio al que van los bugs.
- Graba el bug. Con la extensión de Chrome, Midge para Mac o Midge para iPhone, graba tu pantalla o haz una captura. El reporte incluye la consola, las peticiones de red, tus clics y los datos del dispositivo.
- Envíalo a GitHub. En el reporte, haz clic en Send to GitHub. La app abre el issue y el reporte muestra el issue que ha creado.
Qué contiene el issue de GitHub
GitHub muestra Markdown, así que el issue se puede leer sin abrir nada más:
- un enlace al reporte de Midge con el vídeo y los paneles de consola y de red,
- el resumen de IA,
- los pasos para reproducir numerados, redactados a partir de lo que hiciste en la grabación,
- la causa probable,
- la URL de la página y el número de errores de consola y peticiones fallidas.
Una nota al final indica que el resumen lo escribió la IA a partir de los logs ocultados.
Primero tus palabras
Lo que escribió quien reportó al enviar el reporte, como el resultado esperado o la cuenta que usó, va en el issue justo debajo del enlace, antes del resumen de IA. La persona que vio el bug tiene la primera palabra, y el resumen completa lo que no anotó.
El mínimo acceso
La app Midge Bug Reports pide issues: write y metadata: read, en los repositorios que elijas, y nada más. No puede leer tu código, tus pull requests ni tus Actions, y puedes quitar un repositorio o desinstalar la app desde los ajustes de GitHub en cualquier momento.
Los secretos se quedan fuera de tu repositorio
En los repositorios públicos, el texto de los issues es público. Midge elimina contraseñas, tokens, cookies, cabeceras de autorización y números de tarjeta de los logs antes de que salgan del navegador o del teléfono, y enmascara correos y números de teléfono. El issue se escribe a partir de esos logs ocultados. La grabación en sí se queda en Midge con su propia configuración de uso compartido: «Workspace members» o «Only me» la mantienen privada aunque el issue sea público. Consulta ocultación.
Del issue a la corrección
Un desarrollador abre el issue, entra en la grabación y ve la petición fallida y el stack trace en el momento exacto en que ocurrió el bug. Si trabaja con un agente de código, el mismo enlace va a Claude Code o Cursor, y el agente lee la consola, las peticiones de red y los pasos a través del servidor MCP de Midge.
Quién lo usa
- Equipos de producto pequeños que lo siguen todo en GitHub y no quieren otra herramienta para los bugs.
- QA y soporte, que registran bugs en el repositorio que los ingenieros ya vigilan.
- Mantenedores que quieren reportes con los logs adjuntos en lugar de issues de «no funciona».
Sin la integración
Cada reporte tiene además un enlace que se copia al crearlo. Pégalo en cualquier issue, pull request o discusión y abre el mismo reporte.
Relacionado
- Todas las integraciones: Jira, Linear, Slack y webhooks.
- Cómo escribir un reporte de bug.
- Ejemplos de reportes de bugs.
Midge es gratis, incluida la integración con GitHub: grabaciones ilimitadas, vídeos de hasta 15 minutos y sin marca de agua.
Preguntas frecuentes
- ¿Qué acceso tiene la GitHub App de Midge?
- Issues: write y metadata: read, en los repositorios que elijas al instalarla. No puede leer ni cambiar tu código.
- ¿Quién aparece como autor del issue?
- La app Midge Bug Reports. El issue enlaza al reporte de Midge, que muestra quién lo grabó.
- ¿Funciona con repositorios privados?
- Sí, en cualquier repositorio en el que esté instalada la app. Recuerda que el issue enlaza al reporte; configura el uso compartido del reporte para que lo puedan abrir las personas adecuadas.
- ¿Es compatible con GitHub Enterprise Server o GitLab?
- No, solo con GitHub.com. Un webhook firmado puede abrir issues en otros sitios a través de un pequeño servicio propio.