forgesync
forgesync sincroniza issues y comentarios desde repositorios espejo de GitHub hacia Forgejo, cerrando el bucle de feedback. Es stateless, usa marcadores HTML para rastrear estado y soporta despliegue Docker o binario Go.
Ficha actualizada 24 sept 2026, 7:35 · upstream 24 sept 2026, 7:19 · release sin release detectada
Qué es forgesync
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
forgesync resuelve la desconexión entre un front-end público en GitHub (usado por usuarios externos) y un back-end privado en Forgejo. Permite que los usuarios filen issues en el espejo de GitHub, mientras que forgesync recupera automáticamente esos datos y los escribe en el repositorio fuente de Forgejo.
La herramienta opera de forma stateless mediante marcadores HTML en los cuerpos de los issues y comentarios, lo que evita la necesidad de una base de datos externa. Soporta múltiples objetivos de espejo (GitHub o otros hosts Forgejo) y gestiona automáticamente las etiquetas para mantener la consistencia entre ambos entornos.
Además, ofrece funcionalidades avanzadas como la promoción de PRs desde GitHub a Forgejo mediante comandos en comentarios y el seguimiento de PRs upstream cuando el espejo es un fork. Es ideal para equipos que quieren mantener una presencia pública en GitHub sin duplicar el trabajo de gestión.
- Mantener un repositorio público en GitHub para recibir feedback mientras se desarrolla internamente en Forgejo.
- Sincronizar issues y comentarios de múltiples espejos (GitHub, Codeberg) hacia una única fuente de verdad en Forgejo.
- Promover PRs abiertos en el espejo de GitHub a solicitudes reales en Forgejo mediante comandos automáticos.
- Seguir contribuciones upstream desde forks al importar PRs externos como issues de seguimiento.
- Gestionar etiquetas automáticamente para evitar duplicados o inconsistencias entre repositorios espejo y fuente.
- Arquitectura stateless basada en marcadores HTML, eliminando la necesidad de bases de datos externas.
- Soporte nativo para despliegue Docker con imágenes distroless y ejecución como usuario no root.
- Gestión automática de etiquetas: crea las que faltan en el destino y elimina solo las que añadió forgesync.
- Funcionalidad de promoción de PRs desde GitHub a Forgejo mediante comandos en comentarios específicos.
- Soporte para múltiples objetivos de espejo con autodescubrimiento de tokens por host.
- Implementación en Go con binarios compilados directamente, sin dependencias de runtime complejas.
- No sincroniza comentarios a nivel de línea (line-level review comments), solo la conversación general del issue o PR.
- Requiere permisos de administrador para listar push-mirrors y obtener el estado de los repositorios.
- Los PRs abiertos directamente en GitHub sobre ramas que no existen en Forgejo se cierran al sincronizar.
- Las etiquetas añadidas manualmente en el espejo externo persisten, pero las creadas por forgesync se eliminan si cambian.
- No soporta bases de datos externas; depende enteramente del estado reflejado en los marcadores HTML.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Requiere variables de entorno para tokens (PAT) y URLs. Ejemplo: FORGESYNC_SOURCE_URL, FORGESYNC_SOURCE_TOKEN, FORGESYNC_GITHUB_TOKEN. Para espejos no GitHub, usar FORGESYNC_FORGEJO_TOKEN_<HOST>. El puerto de salud es :8080. Se puede ejecutar con docker compose up -d o instalando el binario Go directamente.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.