Centro de Ayuda

Todo lo que necesitas saber para ordenar tus repositorios en GitHub

Empezar

1

Instalar App

Conecta tu cuenta de GitHub instalando la GitPins App

2

Arrastrar repos

Arrastra los repositorios que quieres mostrar primero

3

Guardar

Pulsa guardar para guardar tu orden y configuración

4

Listo

Sincroniza manualmente desde el dashboard, o programa la sincronización con GitHub Actions

Conectar GitHub App

GitPins usa una GitHub App para interactuar con tus repositorios. Es más seguro que OAuth porque los permisos son granulares y puedes revocarlos en cualquier momento.

Permisos solicitados

PermisoPara qué se usa
Contents (write)Crear y borrar refs temporales para actualizar la recencia del repositorio
Metadata (read)Leer la lista de tus repositorios (nombre, estrellas, lenguaje)

Lo que SÍ puede hacer

  • Leer metadatos de tus repos (nombre, descripción, estrellas)
  • Crear y borrar refs temporales (sin modificar archivos)
  • Crear y borrar refs temporales para aplicar el orden
  • Opcionalmente reescribir historial para limpieza (solo cuando ejecutas limpieza explícitamente)

Lo que NO puede hacer

  • Borrar repositorios
  • Modificar tus archivos versionados
  • Acceder a secrets o variables de entorno
  • Cambiar configuración de repos o permisos

Puedes verificar y revocar permisos en cualquier momento desde github.com/settings/installations

Ordenar repositorios

El dashboard tiene dos zonas: la zona de repos pinneados (arriba) y el pool de todos tus repos (abajo). Arrastra repos entre las zonas para ordenarlos.

Demo interactivo

Haz clic en un repo del pool para añadirlo a la zona pinneada. Usa la X para quitarlo.

Repos pinneados(2/3)
my-awesome-project142
react-components89
Todos los repos
old-experiment12
dotfiles5
learning-rust3

Qué ocurre al guardar

  1. 1.Tu orden se guarda en la base de datos
  2. 2.Se crea un snapshot en el historial (para poder restaurar)
  3. 3.Puedes pulsar Sincronizar ahora para aplicar el orden inmediatamente
  4. 4.Opcional: configura un workflow programado (GitHub Actions) para mantener el orden automáticamente

Configurar sincronización

La sincronización mantiene tus repos en el orden que configuraste. Puedes ejecutarla manualmente o programarla con GitHub Actions.

Frecuencia

Con qué frecuencia la sincronización programada verifica y reordena tus repos.

1-2hMuy frecuente, más consumo de Actions
6hRecomendado - buen balance
24h+Menos frecuente, mínimo consumo

Hora preferida (UTC)

Opcionalmente, elige una hora específica para la sincronización.

Ejemplo:
preferredHour: 14 = 14:00 UTC
Si configuras 14:00 UTC, el sync solo se ejecutará a esa hora

Cómo funciona el GitHub Action

Para ejecutar la sincronización programada, añade un workflow (ejemplo abajo) en un repositorio que controles y haz que llame a tu instancia de GitPins.

# .github/workflows/maintain-order.yml
schedule:
- cron: '0 */6 * * *'
# Ejecuta cada 6 horas

Estrategias de commit

Para actualizar la recencia de un repo, GitPins crea una tag ref temporal que apunta a HEAD y la borra inmediatamente.

Toque con ref temporal

Recomendada
# Step 1
git rev-parse HEAD
# Step 2
git push origin HEAD:refs/tags/gitpins-touch-abc123
# Step 3
git push origin :refs/tags/gitpins-touch-abc123
  • Sin cambios de archivos
  • Sin ruido de commits en el branch principal

Historial y exportación

GitPins registra toda la actividad: cambios de orden, sincronizaciones automáticas y restauraciones. Puedes exportar los datos o restaurar órdenes anteriores.

Qué se registra

  • Cambios manuales de orden
  • Sincronizaciones automáticas
  • Sincronizaciones omitidas
  • Restauraciones de orden

Exportar datos

Descarga tu historial de actividad en dos formatos:

CSVPara Excel/hojas de cálculo
JSONPara análisis o backup

Restaurar orden

Puedes volver a cualquier orden anterior haciendo clic en Restaurar.

Se crea un nuevo snapshot al restaurar, así que siempre puedes deshacer.

Solución de problemas

¿Tienes más preguntas?

Consulta el dashboard o abre un issue en GitHub