Conecta tu proyecto de Atoms a GitHub para mantener su código en un repositorio privado y mover cambios entre Atoms y GitHub sin usar comandos de Git.

Esta guía explica el proceso completo de configuración: conectar tu cuenta de GitHub a Atoms, crear el repositorio, confirmar que la conexión funciona y mantener sincronizadas las versiones de tu proyecto en Atoms y GitHub.

Cómo funciona la conexión

Hay 2 etapas para conectar GitHub:

1. Conecta tu cuenta de GitHub. Esto le da a Atoms permiso para trabajar con GitHub en tu nombre.
2. Crea un repositorio para tu proyecto. Un repositorio es el espacio privado en GitHub donde se almacenan el código y el historial de cambios de tu proyecto.

Actualmente, Atoms crea un nuevo repositorio privado en la cuenta personal de GitHub del usuario conectado. No puedes conectarte a un repositorio existente, crear el repositorio dentro de una organización ni hacerlo público mediante el conector.

Antes de empezar

Antes de conectar tu proyecto a GitHub, asegúrate de que:

• Tu plan de Atoms incluye conexión con GitHub. Si estás en el plan Free, al seleccionar GitHub irás a la página Plans.
• Solo el propietario del espacio de trabajo puede conectar o desconectar GitHub. Si eres editor, pídele al propietario del espacio de trabajo que realice este paso.
• Tienes una cuenta de GitHub o estás listo para crear una durante la configuración.
• Tu navegador permite ventanas emergentes de Atoms.
• Actualmente no hay Agentes trabajando en tu proyecto.

No necesitas un token de acceso personal de GitHub para conectar tu cuenta. Nunca pegues tokens de GitHub, contraseñas ni otras credenciales en el Chat.

Conecta tu cuenta de GitHub

Abre el conector de GitHub

1. Abre el proyecto que quieres conectar.
2. Haz clic en el nombre del proyecto, en la parte superior derecha del panel de chat.
3. Selecciona Connectors en el menú desplegable que aparece.
4. Busca Github en la lista de conectores disponibles y haz clic en connect.

También puedes abrir Settings → Connectors → GitHub y seleccionar Connect.

Abre Settings → Connectors y selecciona Connect para GitHub.

Autoriza Atoms en GitHub

Si Connected Account ya muestra la cuenta de GitHub que quieres usar, ya fue autorizada. Puedes continuar con Create a private repository.

1. Atoms abre una ventana de autorización de GitHub. Inicia sesión en la cuenta de GitHub que quieres conectar o crea una cuenta nueva si es necesario.
2. Comprueba que hayas iniciado sesión en la cuenta correcta de GitHub.
3. Revisa los permisos solicitados por Atoms. Si estás de acuerdo, selecciona Authorize Atoms-Agents.
4. Vuelve a Atoms y espera el mensaje Connect success.
5. En Atoms, abre Connectors y confirma que tu cuenta de GitHub aparece como conectada.

Atoms solicita los permisos OAuth repo, read:user y workflow. Estos permiten a Atoms leer y escribir repositorios públicos y privados a los que la cuenta conectada puede acceder, leer información básica del perfil y agregar o actualizar archivos de flujo de trabajo de GitHub Actions.

Esta autorización se aplica a la cuenta de GitHub conectada y no se limita al repositorio creado para el proyecto actual de Atoms. Atoms no puede acceder a repositorios a los que la propia cuenta conectada no puede acceder, y las políticas de la organización pueden imponer restricciones adicionales.

Revisa los permisos de GitHub y selecciona Authorize Atoms-Agents.

Crea un repositorio privado

Después de autorizar tu cuenta de GitHub, crea el repositorio privado que almacenará el código de tu proyecto.

1. En Connected Account, comprueba que el nombre de usuario mostrado coincida con la cuenta de GitHub que quieres usar.
2. En Create New Repository, introduce un nombre para el repositorio. El nombre debe:
   • contener entre 1 y 100 caracteres;
   • usar solo letras, números, guiones (-), guiones bajos (_) o puntos (.).
3. Selecciona Create.
4. Espera el mensaje GitHub repository connected successfully!.

Atoms crea un nuevo repositorio privado en la cuenta personal de GitHub del usuario conectado, lo vincula al proyecto actual de Atoms y luego intenta subir los archivos actuales del proyecto a GitHub.

Introduce un nombre y crea un nuevo repositorio privado.

Comprueba que la conexión funcionó

Comprueba la conexión tanto en Atoms como en GitHub antes de confiar en el repositorio.

1. En Atoms, confirma que Repository Status muestra Connected.
2. En Branches, comprueba que una rama tenga una marca de verificación. Esta es la rama actualmente conectada a tu proyecto de Atoms. Si eres nuevo en GitHub, mantén esta rama seleccionada.
3. Selecciona View on GitHub.
4. En GitHub, confirma que el repositorio:
   • pertenece a la cuenta correcta de GitHub;
   • está marcado como Private;
   • contiene los archivos esperados del proyecto; y
   • tiene al menos un commit.

Si el repositorio está vacío y Push Changes está disponible en Atoms, selecciónalo y espera a que termine la operación. Luego actualiza la página del repositorio en GitHub y comprueba que ahora aparezcan los archivos del proyecto.

Comprueba el repositorio conectado y la rama seleccionada en Atoms.

Verifica el repositorio privado y los archivos del proyecto en GitHub.

Mantén Atoms y GitHub sincronizados

Atoms y GitHub no se mantienen sincronizados automáticamente. Cuando se hayan realizado cambios en uno de los lados, usa los controles de sincronización para mover esos cambios al otro.

Acción	Úsalo cuando	Qué sucede
Push Changes	Hiciste cambios en Atoms y quieres enviarlos a GitHub.	Atoms envía los archivos actuales del proyecto a la rama seleccionada de GitHub.
Pull Updates	Se hicieron cambios en la rama seleccionada en GitHub y quieres traerlos a Atoms.	Atoms actualiza el proyecto con los cambios más recientes de GitHub.

Antes de enviar o traer cambios, espera a que el Agente termine y asegúrate de estar viendo la versión más reciente del proyecto en el Chat. Si abriste una versión anterior desde History, vuelve a la tarjeta de la versión más reciente en la parte inferior del Chat y luego vuelve a abrir GitHub.

Si no estás en la versión más reciente, Atoms muestra You must be on the latest version to pull updates or push changes.

Antes de sincronizar, comprueba también que la rama seleccionada sea la que quieres actualizar.

Si tanto Atoms como GitHub contienen cambios que necesitas conservar, no los sincronices todavía. Guarda primero una copia del trabajo importante o pide ayuda a alguien familiarizado con GitHub para conservar los cambios en una rama separada.

Si Repository Status muestra Upstream Changes Available, GitHub contiene cambios que Atoms aún no tiene. Revisa el repositorio antes de elegir una acción.

Usa Pull Updates y Push Changes para la rama seleccionada.

Enviar cambios de Atoms a GitHub

1. Termina de hacer tus cambios en Atoms y espera a que el Agente deje de trabajar.
2. Asegúrate de estar viendo la versión más reciente del proyecto.
3. Abre Settings → Connectors → GitHub y comprueba que esté seleccionada la rama correcta.
4. Selecciona Push Changes.
5. Mantén la página abierta mientras se envían los cambios.
6. Cuando aparezca Changes pushed successfully, selecciona View on GitHub y comprueba que los archivos más recientes del proyecto estén allí.

Push Changes está disponible solo cuando Atoms tiene cambios que aún no se han enviado a GitHub. No está disponible mientras el Agente está trabajando o cuando estás viendo una versión anterior del proyecto.

Una vez que selecciones Push Changes, los cambios se envían a GitHub de inmediato sin pedir confirmación. Si el mismo archivo se cambió tanto en Atoms como en GitHub, la versión de Atoms tiene prioridad y sobrescribirá la versión almacenada actualmente en GitHub.

Traer actualizaciones de GitHub a Atoms

A diferencia de enviar cambios, traer cambios requiere confirmación primero. Si el mismo archivo se cambió tanto en GitHub como en Atoms, la versión de GitHub tiene prioridad y sobrescribirá la versión actual en Atoms.

1. Abre Settings → Connectors → GitHub.
2. Comprueba que Repository Status muestre nuevos cambios de GitHub y que esté seleccionada la rama correcta.
3. Selecciona Pull Updates.
4. Lee la advertencia Pull May Affect Project. Si quieres traer los cambios de GitHub a tu proyecto actual de Atoms, selecciona Confirm.
5. Mantén la página abierta mientras se traen los cambios.
6. Cuando aparezca Changes pulled successfully, abre el Visor de Apps y prueba las partes de tu proyecto afectadas por los cambios para asegurarte de que todo siga funcionando como se espera.

Pull Updates está disponible solo cuando la rama seleccionada de GitHub contiene cambios que aún no se han traído a Atoms.

Desconectar GitHub

Desconecta GitHub cuando ya no quieras que Atoms acceda a la cuenta conectada. El repositorio de GitHub y sus archivos permanecerán en GitHub, pero Atoms ya no podrá enviar ni traer cambios.

La autorización de GitHub se aplica a la cuenta conectada. Revocar el acceso desconecta todos los proyectos de Atoms que usan esa cuenta de GitHub, así que revisa tus otros proyectos antes de continuar.

1. Abre Settings → Connectors → GitHub.
2. Selecciona Disconnect.
3. En la confirmación Disconnect GitHub, selecciona Disconnect otra vez.
4. GitHub debería abrir automáticamente la página de autorización correspondiente. Si no lo hace, en GitHub ve a Settings → Applications → Authorized OAuth Apps.
5. Busca Atoms, selecciona ... a la derecha de su fila y luego selecciona Revoke. No selecciones Revoke all; esa acción elimina el acceso de todas las apps OAuth autorizadas que aparecen en la página.
6. Sigue cualquier paso de confirmación necesario en Github.
7. Vuelve a Atoms y vuelve a abrir el conector de GitHub para confirmar que la cuenta ya no está conectada.

Selecciona Disconnect en el conector de GitHub.

Revoca solo la aplicación OAuth de Atoms en GitHub.