Sincronización con GitHub
Conecta GitHub con un código de dispositivo o un token, publica un proyecto como repositorio nuevo o existente, sube y descarga cambios entre equipos, y cómo se protege tu token.
La sincronización con GitHub es una copia de seguridad opcional fuera de tu equipo y un traspaso entre varios equipos, construida sobre el repositorio de Git real que ya es cada proyecto. Los commits locales funcionan sin GitHub. Cuando te conectas, sigue sin haber una cuenta de Oleafly: solo tu GitHub.
Conecta tu cuenta
Sección titulada «Conecta tu cuenta»En Ajustes, Integraciones, GitHub, y luego cualquiera de las dos rutas:
- Conectar GitHub (recomendado): un flujo con código de dispositivo. Oleafly muestra un código corto, tu navegador abre
github.com/login/device(con un botón Copiar para el código), tú apruebas y la app lo detecta en unos segundos. La conexión solo solicita los permisosrepoyread:user. - Token de acceso personal: despliega “Avanzado: usar un token de acceso personal” y pega un PAT si prefieres generar tus propias credenciales.
Una vez conectado, tu avatar y tu nombre de usuario aparecen en Ajustes y en el menú de GitHub de la barra de herramientas superior. Desconectar olvida el token.
Cómo se protege tu token
Sección titulada «Cómo se protege tu token»El token se guarda en un archivo local cifrado con AES-256-GCM y restringido a su propietario, y nunca se entrega a la capa de interfaz de la app; la interfaz solo llega a saber “conectado como @tú”. Cuando Git necesita autenticarse, el token se inyecta mediante un asistente de credenciales en memoria, de modo que nunca aparece en una línea de comandos, en .git/config ni en el historial de tu shell. Las compilaciones antiguas que incrustaban tokens en las URL de los remotos se limpian automáticamente al iniciar.
Publica un proyecto
Sección titulada «Publica un proyecto»En el panel del Control de versiones, haz clic en Publicar en GitHub:
- Crear un repositorio nuevo: elige un nombre (rellenado de antemano a partir del proyecto), deja marcada o desmarcada la casilla Privado (recomendado dejarla marcada) y pulsa Crear y subir. Oleafly crea el repositorio, confirma los archivos del proyecto, configura
originy sube. - Enlazar uno existente: elige en una lista con búsqueda de tus repositorios (los privados muestran un candado) y pulsa Enlazar y subir.
Después de publicar, el menú de GitHub de la barra de herramientas ofrece Abrir en GitHub y Copiar el enlace del repositorio.
Los archivos que parecen secretos se quedan en local
Sección titulada «Los archivos que parecen secretos se quedan en local»Publicar nunca confirma archivos que suelen contener claves o contraseñas, como .env, *.pem, claves privadas SSH o credentials.json. Se quedan en la carpeta del proyecto, sin preparar, y el diálogo los nombra. Para publicar uno de todos modos, prepáralo y confírmalo tú mismo en el Control de versiones. Las plantillas como .env.example, las claves públicas y los archivos .key de Keynote se publican como siempre.
Una subida envía todo el historial. Si alguna vez se confirmó un archivo con uno de estos nombres, Oleafly lo enumera y espera a que elijas Cancelar o Publicar de todos modos antes de crear nada en GitHub.
Sincronización del día a día
Sección titulada «Sincronización del día a día»Los botones Subir y Descargar del panel del Control de versiones hacen lo que dicen, contra origin en tu rama actual. Traer y Sincronizar están en el menú Más acciones del control de versiones, y Confirmar y subir y Confirmar y sincronizar están en el menú junto a Confirmar. El indicador de por delante/por detrás (↑ ↓) junto a la etiqueta de la rama te avisa cuando hay algo que subir o descargar.
Dos equipos
Sección titulada «Dos equipos»- En el equipo A: publica el proyecto, trabaja y usa Subir.
- En el equipo B: conecta la misma cuenta de GitHub y luego elige Importar un proyecto → GitHub y selecciona el repositorio. Consulta la guía de importación. A partir de ahí: Descargar, trabaja y Subir.
- De vuelta en A: usa Descargar antes de empezar. El indicador te lo recuerda.
El color de portada, la elección del documento principal y el historial viajan con el proyecto, porque viven en la propia carpeta del proyecto.
Cambiar de opinión
Sección titulada «Cambiar de opinión»Una vez que hay un remoto configurado, el menú Más acciones del control de versiones tiene dos elementos más:
- Cambiar de repositorio vuelve a abrir el diálogo de publicación para apuntar
origina otro lugar. - Desenlazar quita el remoto; el proyecto local y su historial quedan intactos.
Conflictos y ramas
Sección titulada «Conflictos y ramas»Si una descarga produce un conflicto de fusión, el Control de versiones enumera los archivos en conflicto. Elige Usar la actual o Usar la entrante para cada uno, o edita el archivo y elige Marcar como resuelto, y luego Completar la fusión. Cancelar la fusión devuelve los archivos a como estaban. Subir y descargar funcionan en la rama que tienes activa, y el menú de ramas en la parte superior del panel cambia o crea ramas. Consulta Git y control de versiones.
Límites, dichos con claridad
Sección titulada «Límites, dichos con claridad»Oleafly autentica los remotos HTTPS. Publicar configura uno correctamente por ti.
Si algo falla
Sección titulada «Si algo falla»- “No remote ‘origin’”: publica primero; Subir y Descargar necesitan un remoto.
- Subida rechazada porque el remoto tiene commits: descarga primero y luego sube.
- “No GitHub token set”: conéctate en Ajustes, Integraciones, GitHub.
Más información en las preguntas frecuentes.