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 activar la sincronización automática

4

Listo

El GitHub Action mantiene tu orden automáticamente

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 commits vacíos para actualizar la fecha de último commit
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 commits vacíos (sin modificar archivos)
  • Crear y borrar branches temporales
  • Crear el repositorio gitpins-config

Lo que NO puede hacer

  • Borrar repositorios
  • Leer, modificar o eliminar tu código
  • 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.Se activa el GitHub Action en tu repo gitpins-config
  4. 4.En la próxima ejecución, el Action ordenará tus repos

Configurar sincronización

La sincronización mantiene tus repos en el orden que configuraste. Un GitHub Action se ejecuta periódicamente y reordena si es necesario.

Frecuencia

Con qué frecuencia el Action 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

Cuando guardas tu orden, se crea un workflow en tu repositorio gitpins-config que se ejecuta según la frecuencia configurada.

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

Estrategias de commit

Para actualizar la fecha de último commit de un repo, GitPins necesita crear un commit. Hay dos estrategias disponibles:

Commit + Revert

Recomendada
# Step 1
git commit --allow-empty -m "[GitPins]"
# Step 2
git revert HEAD --no-edit
# Step 3 (auto cleanup)
git rebase -i HEAD~2 (drop both)
  • Historial completamente limpio
  • Limpieza automática de commits

Branch temporal

# Step 1
git checkout -b gitpins-temp
# Step 2
git commit --allow-empty -m "[GitPins]"
# Step 3
git checkout main && git merge
# Step 4
git branch -d gitpins-temp
  • Funciona en todos los casos
  • ~Deja merge commits en el historial

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