# 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.

Aplica a: Sypnia Cloud (servicio pago). Estado: al lanzar.  
Fuente: https://docs.sypnia.com/es/cloud/github-app/

**\[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](https://docs.sypnia.com/es/agent/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](https://docs.sypnia.com/es/agent/models-and-what-is-sent).
- **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.

### 1. Empieza desde el proyecto

En la app, abre la configuración del proyecto y elige conectar GitHub. Tienes que ser dueño o administrador de la organización en Sypnia.

**Deberías ver:**Te lleva a GitHub, a la página de instalación de la app de Sypnia.

### 2. 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 ver:**GitHub lista los tres permisos de arriba y los repositorios que elegiste.

### 3. 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 ver:**La configuración del proyecto muestra el repositorio.

### 4. Enciende los pull requests del proyecto

En la misma configuración, enciende los pull requests. Hasta que lo hagas, Sypnia lee qué cambió entre versiones y no abre nada.

**Deberías ver:**Un problema abierto con una causa clara muestra «Abrir pull request».

## 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](https://docs.sypnia.com/es/cloud/plans-and-limits).
- 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:

```text
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.
