Conectar un repo
SeeRepo lee tu código con una GitHub App: de solo lectura, y solo en los repos que elijas. Tener acceso en GitHub todavía no dibuja nada: un repo solo se lee cuando lo eliges en SeeRepo.
Conectar va en tres pasos, arriba de la página: Instala en GitHub, Elige un repo y Tu mapa.
Paso 1: Instala la GitHub App
La primera vez, la página dice «Primero, deja que SeeRepo vea tus repos» con un solo botón, Instalar en GitHub. GitHub pregunta dónde instalar la app de SeeRepo: elige todos tus repos o solo algunos. Lo puedes cambiar después con Dale acceso a SeeRepo a más repos en GitHub. De vuelta en SeeRepo, una línea verde dice que GitHub está conectado y cuántos repos están listos para elegir.
La app le pide a GitHub solo acceso de lectura:
- Contenido: los archivos, para dibujar el mapa.
- Metadatos: el nombre del repo, sus ramas y si es privado.
- Checks: si tus pruebas automáticas (CI) pasan.
- Direcciones de correo: para escribirte sobre tus mapas.
Escucha dos eventos: cada push, para tener el mapa al día, y cada corrida de pruebas que termina.
Si tu repo tiene un sitio publicado, una vez al día SeeRepo también pide sus páginas públicas, con su propio agente, para saber cómo las ven Google y la IA. Lo cuenta la Política de privacidad.
Paso 2: Elige tu repo
En ¿Qué repo quieres ver?, busca con Busca en tus repos y elige uno. Cada repo dice Privado o Público.
Bajo la lista, una frase dice cómo se dibujará su mapa, por ejemplo «Mapa en español, con la hora de Madrid.». Las dos cosas vienen puestas: tu idioma y la zona horaria de tu navegador, que define qué significa «hoy» en tu proyecto. Toca Cambiar para elegir otras. Sitio web es opcional: «Su icono pasa a ser el icono de tu proyecto. Puedes cambiarlo después».
Paso 3: Tu mapa
Haz clic en Dibujar mi proyecto. El botón muestra que está trabajando, y tu mapa se abre con su primera carga en marcha.
Un repo público que no es tuyo
Bajo tus repos, pega el enlace de cualquier repo público de GitHub, por ejemplo github.com/vercel/next.js, y toca Dibujarlo. No hace falta instalar nada.
- Su mapa es público y el mismo para todos, en
seerepo.com/r/dueño/repo. Quien lo abre lo pone al día. - Entra en tu panel con la etiqueta Público. Pasa el cursor sobre su tarjeta y toca Quitar para sacarlo de tu panel; el mapa sigue ahí para todos.
- No usa ninguno de los repos ni de los commits de tu plan.
- SeeRepo lee un número limitado de repos públicos nuevos cada día. Cuando se acaban, lo dice: inténtalo al día siguiente.
Un repo tuyo se conecta mejor desde la lista de arriba, así su mapa sigue cada push.
Seguir una segunda rama
SeeRepo sigue la rama principal de tu repo en GitHub. Para ver también otra, como la rama donde un agente está rehaciendo tu app, abre los ajustes del proyecto: General → Ramas → Seguir otra rama. Elígela de tus ramas en GitHub y toca Dibujar esta rama.
- Es otra primera carga: SeeRepo lee la rama entera y dibuja su propio mapa, con sus módulos y su historia.
- Hasta dos ramas por proyecto, gratis con cualquier plan. La segunda no usa ninguno de los repos de tu plan, y un commit que está en las dos ramas cuenta una sola vez. Tu repo gratis sigue una rama.
- Con dos ramas, las pestañas junto al nombre del proyecto cambian entre sus mapas, y la tarjeta del proyecto en tu panel nombra la segunda; sus cifras siguen siendo las de la rama principal. Quien tiene el proyecto compartido ve las dos. El enlace público siempre muestra la rama principal.
- Cuando la rama se borra en GitHub, su mapa se congela y dice si antes se integró. Se queda 7 días y luego sale del proyecto.
- Dejar de seguir la quita antes. En GitHub no cambia nada, y su mapa se guarda: síguela otra vez y vuelve al día.
Quitar un proyecto de tu panel
Abre el proyecto y luego sus ajustes: General, la última tarjeta, Quitarlo de tu panel. Antes de que pase nada, SeeRepo te dice qué significa para ese proyecto, y solo lo que es cierto para él:
- Su mapa se guarda. Puedes volver a conectarlo desde Conectar un repo, y se lee otra vez desde el principio.
- Si lo compartiste, quien lo tenía lo pierde; para devolvérselo, tendrías que invitarlo otra vez.
- Si tiene enlace público, el enlace deja de funcionar hasta que lo vuelvas a conectar.
- Si sigue una segunda rama, SeeRepo deja de seguirla también; su mapa se guarda.
- Con un plan, libera uno de los repos de tu plan. Cuando ya usas todos los repos de tu plan, Conectar un repo muestra tus proyectos, cada uno a un clic de esta tarjeta.
- Sin plan, solo puede volver tu repo gratis.
- Si GitHub ya no le comparte el repo a SeeRepo, vuelve a Conectar un repo cuando le des acceso a SeeRepo en GitHub.
Un repo público que agregaste por su enlace no tiene ajustes propios: pasa el cursor sobre su tarjeta y toca Quitar.
Qué lee SeeRepo y qué guarda
Para leer un repositorio SeeRepo hace una copia temporal de sus archivos y la borra en cuanto termina el trabajo. Tu código nunca se guarda. Lo que queda es el mapa, sus frases, sus cifras y el historial de commits de cada rama que SeeRepo sigue: mensaje, autor, fecha y archivos.
Para leer cada push más rápido, el servidor de SeeRepo guarda además la historia de git de las ramas que sigue, nunca lo que hay dentro de un archivo: el mensaje completo y la fecha de cada commit, los nombres y correos de quienes lo hicieron y los nombres de todos sus archivos y carpetas. Se borra tras 14 días sin una lectura nueva, y en pocos minutos cuando quitas el proyecto de tu panel, GitHub deja de compartirle el repo a SeeRepo o borras tu cuenta (salvo que alguien más también lo tenga en SeeRepo).
Lo que hay dentro de las rutas que agregues en Ignorar, en los ajustes del proyecto, nunca se lee. SeeRepo no usa tu código ni tus datos para entrenar modelos de IA. En la Política de privacidad está quién procesa qué.