Documentación · Empezar

Empezar en 5 minutos

Necesitas una cuenta de GitHub y un repo con permiso para instalar apps.

1. Entra

Entra en app.vibethia.com con GitHub.

2. Conecta un repo

Pulsa Vigilar un repo, instala la app de Vibethia en tu cuenta u organización y elige el repo. Puedes elegir solo uno: la app no pide acceso a los demás.

3. Aprueba el PR

La app abre un PR en tu repo con un fichero: .github/workflows/vibethia.yml. También guarda un secreto, VIBETHIA_TOKEN. Revisa el PR y fusiónalo.

El workflow corre en tus Actions y gasta minutos de tu cuenta de GitHub.

4. Espera al primer escaneo

Al fusionar, el workflow corre solo. Tarda unos minutos. Cuando acaba, el repo aparece en el panel con sus hallazgos.

5. Mira qué hay que corregir

Arriba ves el embudo: cuántos avisos dieron los escáneres y cuántos quedan para corregir. Debajo, la lista, con lo más urgente primero. Abre un hallazgo para ver por qué tiene ese veredicto.

Si es un secreto real, quitarlo del código no basta. Tienes que rotarlo en el servicio que lo dio.

Si algo no sale

  • El PR no aparece. Comprueba que la app tiene acceso a ese repo.
  • El workflow falla. Abre la ejecución en Actions: el paso que falla dice por qué.
  • El repo sale «sin escaneo». El PR sigue sin fusionar.