Docs

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 Nube Al lanzar

Ver como Markdown
En esta página
  1. No la necesitas
  2. Qué puede hacer la app
  3. Qué no hace nunca la app
  4. Qué pasa con tu código
  5. Instálala
  6. Empieza desde el proyecto
  7. Elige dónde instalarla, y en qué repositorios
  8. Conecta el repositorio al proyecto
  9. Enciende los pull requests del proyecto
  10. Límites
  11. Quítala
  12. Ejemplo: la tienda

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 GitHubPara qué lo necesita Sypnia
Contents: lectura y escrituraLeer los archivos que necesita un arreglo y lo que cambió entre dos versiones. Escribir su propia rama, sypnia/<problem slug>.
Pull requests: lectura y escrituraAbrir el pull request, y leer si se mezcló o se cerró.
Metadata: lecturaLo 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.

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

Secciones

Empieza aquíQué es Sypnia, cómo funciona, qué es código abierto y qué es la nube de pago, y las dos maneras de recibir tu primer problema en palabras claras.ConceptosLas diez ideas de las que está hecho Sypnia, cada una definida con precisión, desde un proyecto y sus llaves hasta los problemas, las trazas y las alertas.SDKCómo envía tu app los datos a Sypnia. Un SDK para el navegador, uno para Node, uno para Next.js, y la entrada de OpenTelemetry para cualquier otro backend.El agenteCómo analiza Sypnia un problema, qué escribe, qué le envía a un modelo y qué nunca hace.MCP y skillsConecta tu agente de código a Sypnia para que pregunte qué está fallando en producción, lea lo que necesita para arreglarlo y configure Sypnia por ti.Referencia de la APILa API HTTP de Sypnia: una sola API para el motor de código abierto y para Sypnia Cloud, con cada endpoint, parámetro, respuesta y error.Referencia de la CLIEl comando sypnia: cómo instalarlo, qué variables lee, qué significan sus códigos de salida y dónde está documentado cada comando.Alojamiento propioQué corres cuando alojas tú mismo el motor de Sypnia, qué necesitas, cuánto cuesta y qué no tienes frente a Sypnia Cloud.Cómo está construido el motorTodo el motor de Sypnia en una página, desde un clic en tu app hasta la frase que lee tu agente de código, con las reglas de diseño y el código que las sostiene.Sypnia CloudCómo funciona el servicio pago, desde las organizaciones y los roles hasta los planes, los límites, la facturación, dónde viven tus datos, la GitHub App y el soporte.Privacidad y seguridadQué recoge Sypnia de tu app y de sus usuarios, qué no recoge nunca, cómo funciona el enmascarado, cómo eliminar datos y cómo se protege el servicio.LicenciasQué licencia cubre cada parte de Sypnia, qué puedes hacer con ella, cómo se puede usar el nombre, y los términos de una contribución.GuíasRecetas paso a paso para las formas comunes de usar Sypnia, desde apps hechas con constructores de IA y Next.js en Vercel hasta Supabase, source maps en CI, correos de alerta desde tu propio motor, y venir desde Sentry.ReferenciaLas páginas donde se consulta, desde el esquema de eventos y el glosario hasta lo planeado, el registro de cambios y las preguntas frecuentes.
↑↓ para moverte↵ para abrirEsc para cerrar