La GitHub App
Qué puede hacer la GitHub App de Sypnia en tus repositorios, qué no hace nunca, qué pasa con tu código, y cómo instalarla y quitarla.
Nube Esta página es para quien decide si Sypnia puede tocar un repositorio. La GitHub App solo existe en Sypnia Cloud, y los pull requests son parte de los planes Builder y Team, no del plan Free. El motor de código abierto no abre pull requests: ahí el arreglo le llega a tu propio agente de código por el prompt o por el servidor MCP.
La GitHub App de Sypnia es la forma en que un arreglo llega como pull request. Lee el repositorio, escribe una rama llamada sypnia/<problem slug> y abre un pull request con el cambio y una prueba. Una persona lo revisa y lo mezcla. Sypnia nunca mezcla código.
Cómo se escribe un pull request, qué contiene y cómo revisarlo está en Pull requests. Esta página trata de la app en sí: instalarla, qué puede hacer y quitarla.
No la necesitas
Sin la app, todo lo demás funciona: los problemas, la frase en palabras simples, el prompt y el servidor MCP. Instálala solo si quieres que Sypnia abra pull requests, o que lea qué cambió entre dos versiones.
Instalar la app no enciende los pull requests. Son un ajuste de cada proyecto, apagado hasta que un dueño o un administrador lo enciende, y Sypnia no abre ningún pull request en un proyecto donde está apagado.
Qué puede hacer la app
Cuando la instalas, GitHub muestra los permisos que pide. Son estos, y ningún otro.
| Permiso en GitHub | Para qué lo necesita Sypnia |
|---|---|
| Contents: lectura y escritura | Leer los archivos que necesita un arreglo y lo que cambió entre dos versiones. Escribir su propia rama, sypnia/<problem slug>. |
| Pull requests: lectura y escritura | Abrir el pull request, y leer si se mezcló o se cerró. |
| Metadata: lectura | Lo exige GitHub para toda app: el nombre del repositorio y su rama por defecto. |
Tú eliges a qué repositorios puede llegar la app, en GitHub, cuando la instalas. Elige solo aquellos en los que Sypnia deba trabajar. La app no puede llegar a ningún otro.
Qué no hace nunca la app
- Nunca mezcla un pull request.
- Nunca hace push a tu rama por defecto, ni a ninguna rama que no sea su propia rama
sypnia/…. - Nunca hace force-push ni borra una rama.
- Nunca cambia la configuración del repositorio, los secretos, los permisos de los workflows ni los colaboradores.
- Nunca abre un pull request en un proyecto donde los pull requests están apagados, que es como empieza todo proyecto.
- Nunca abre uno por su cuenta, salvo que también lo pidas. Con los pull requests encendidos, alguien de tu organización, o una credencial con el alcance
admin, pide cada uno. Un segundo ajuste, también apagado por defecto, le permite a Sypnia abrir uno por su cuenta cuando un análisis tiene confianza alta. - Nunca escribe un arreglo que no puede justificar. Si el análisis no tiene una causa clara, o su confianza es baja, Sypnia lo dice y no abre nada.
Tus reglas de protección de ramas, las revisiones obligatorias y las comprobaciones valen para los pull requests de Sypnia igual que para los de cualquiera.
Qué pasa con tu código
- Se lee cuando hace falta. Sypnia lee los archivos que necesita cuando escribe un arreglo, y lo que cambió entre dos versiones cuando tu build no lo envió. No guarda una copia de tu repositorio.
- Se envía a un modelo. Para escribir un arreglo, las partes relevantes de esos archivos van a un modelo, al que se llega por OpenRouter, con los ajustes que les prohíben a los proveedores conservar los datos o entrenar con ellos. Qué se envía exactamente está en Modelos y qué se envía.
- Se guarda con el problema. Las líneas de código que el análisis cita como evidencia se guardan con el problema, y se eliminan con él.
Instálala
Al final tendrás un repositorio conectado a un proyecto, los pull requests encendidos en él, y una acción «Abrir pull request» en los problemas de ese proyecto. Necesitas el plan Builder o el plan Team.
Elige dónde instalarla, y en qué repositorios
En GitHub, elige tu usuario o tu organización de GitHub, después «Only select repositories», y escoge el repositorio de tu app. Necesitas permiso en GitHub para instalar apps ahí; si no lo tienes, GitHub ofrece enviarle una solicitud a alguien que sí.
Deberías verGitHub lista los tres permisos de arriba y los repositorios que elegiste.Conecta el repositorio al proyecto
De vuelta en Sypnia, elige cuál de esos repositorios tiene el código de este proyecto. Un proyecto se conecta a un repositorio. Varios proyectos pueden conectarse al mismo repositorio, que es lo normal en un monorepo.
Deberías verLa configuración del proyecto muestra el repositorio.
Límites
- Los pull requests no están incluidos en el plan Free. Los planes Builder y Team incluyen una cantidad de pull requests al mes para toda la organización; los números están en la tabla de Planes y límites.
- Un problema tiene como máximo un pull request abierto de Sypnia a la vez.
- Al lanzar, la app funciona con repositorios en GitHub.com. GitHub Enterprise Server, GitLab y Bitbucket no están soportados. Con ellos, usa el prompt o el servidor MCP.
Quítala
Puedes quitar el acceso en cualquier momento, y no necesitas a Sypnia para hacerlo.
- Desconectar un proyecto: en la configuración del proyecto en Sypnia. La app sigue instalada en GitHub.
- Quitar un repositorio, o desinstalar la app: en GitHub, en la configuración de la instalación. Sypnia pierde el acceso de inmediato.
Las ramas y los pull requests que Sypnia ya abrió se quedan en tu repositorio; son tuyos. Los problemas conservan su análisis. Pedir un pull request en un proyecto sin repositorio conectado, o con los pull requests apagados, se rechaza con un mensaje que lo dice.
Ejemplo: la tienda
La tienda está en el plan Builder. Su dueña instala la app solo en el repositorio acme/shop, lo conecta al proyecto shop y enciende los pull requests de ese proyecto.
Cuando el botón Pagar se rompe, el problema muestra «Abrir pull request». Ella hace clic. Unos minutos después aparece un pull request en GitHub:
Read the cart total from its new field
sypnia/pay-button-does-nothing -> main
opened by Sypnia
Fixes the problem 3 people hit today.
Changes src/checkout/checkout.tsx and adds a test that fails
when the amount is missing.El repositorio exige una revisión y que las pruebas pasen. Ella lee el cambio, las pruebas pasan, y lo mezcla. Usó uno de los pull requests del mes.