Conecte seu projeto Atoms ao GitHub para manter seu código em um repositório privado e mover alterações entre Atoms e GitHub sem usar comandos Git.

Este guia explica todo o processo de configuração: conectar sua conta do GitHub ao Atoms, criar o repositório, confirmar que a conexão está funcionando e manter as versões do seu projeto no Atoms e no GitHub sincronizadas.

Como a conexão funciona

Há 2 etapas para conectar o GitHub:

1. Conecte sua conta do GitHub. Isso dá ao Atoms permissão para trabalhar com o GitHub em seu nome.
2. Crie um repositório para seu projeto. Um repositório é o espaço privado no GitHub onde o código e o histórico de alterações do seu projeto são armazenados.

Atualmente, o Atoms cria um novo repositório privado na conta pessoal do GitHub do usuário conectado. Você não pode se conectar a um repositório existente, criar o repositório em uma organização nem torná-lo público por meio do conector.

Antes de começar

Antes de conectar seu projeto ao GitHub, certifique-se de que:

• Seu plano do Atoms inclui conexão com GitHub. Se você estiver no plano Free, selecionar GitHub levará você à página Plans.
• Somente o proprietário do workspace pode conectar ou desconectar o GitHub. Se você for um editor, peça ao proprietário do workspace para realizar esta etapa.
• Você tem uma conta do GitHub ou está pronto para criar uma durante a configuração.
• Seu navegador permite janelas pop-up do Atoms.
• Nenhum Agente está trabalhando atualmente no seu projeto.

Você não precisa de um token de acesso pessoal do GitHub para conectar sua conta. Nunca cole tokens do GitHub, senhas ou outras credenciais no Chat.

Conecte sua conta do GitHub

Abra o conector do GitHub

1. Abra o projeto que você deseja conectar.
2. Clique no nome do projeto, no canto superior direito do painel de chat.
3. Selecione Connectors no menu suspenso que aparece.
4. Encontre Github na lista de conectores disponíveis e clique em connect.

Você também pode abrir Settings → Connectors → GitHub e selecionar Connect.

Abra Settings → Connectors e selecione Connect para GitHub.

Autorize o Atoms no GitHub

Se Connected Account já mostrar a conta do GitHub que você deseja usar, ela já foi autorizada. Você pode continuar para Create a private repository.

1. O Atoms abre uma janela de autorização do GitHub. Entre na conta do GitHub que você deseja conectar ou crie uma nova conta, se necessário.
2. Verifique se você está conectado à conta correta do GitHub.
3. Revise as permissões solicitadas pelo Atoms. Se concordar, selecione Authorize Atoms-Agents.
4. Volte ao Atoms e aguarde a mensagem Connect success.
5. No Atoms, abra Connectors e confirme que sua conta do GitHub aparece como conectada.

O Atoms solicita as permissões OAuth repo, read:user e workflow. Elas permitem que o Atoms leia e grave repositórios públicos e privados aos quais a conta conectada pode acessar, leia informações básicas de perfil e adicione ou atualize arquivos de fluxo de trabalho do GitHub Actions.

Esta autorização se aplica à conta do GitHub conectada e não está limitada ao repositório criado para o projeto atual do Atoms. O Atoms não pode acessar repositórios aos quais a própria conta conectada não pode acessar, e políticas da organização podem impor restrições adicionais.

Revise as permissões do GitHub e selecione Authorize Atoms-Agents.

Crie um repositório privado

Depois de autorizar sua conta do GitHub, crie o repositório privado que armazenará o código do seu projeto.

1. Em Connected Account, verifique se o nome de usuário exibido corresponde à conta do GitHub que você deseja usar.
2. Em Create New Repository, insira um nome para o repositório. O nome deve:
   • conter de 1 a 100 caracteres;
   • usar apenas letras, números, hífens (-), sublinhados (_) ou pontos (.).
3. Selecione Create.
4. Aguarde a mensagem GitHub repository connected successfully!.

O Atoms cria um novo repositório privado na conta pessoal do GitHub do usuário conectado, vincula-o ao projeto atual do Atoms e então tenta enviar os arquivos atuais do projeto para o GitHub.

Insira um nome e crie um novo repositório privado.

Verifique se a conexão funcionou

Verifique a conexão tanto no Atoms quanto no GitHub antes de confiar no repositório.

1. No Atoms, confirme que Repository Status mostra Connected.
2. Em Branches, verifique se uma branch tem uma marca de seleção. Esta é a branch atualmente conectada ao seu projeto no Atoms. Se você é novo no GitHub, mantenha esta branch selecionada.
3. Selecione View on GitHub.
4. No GitHub, confirme que o repositório:
   • pertence à conta correta do GitHub;
   • está marcado como Private;
   • contém os arquivos esperados do projeto; e
   • tem pelo menos um commit.

Se o repositório estiver vazio e Push Changes estiver disponível no Atoms, selecione-o e aguarde a conclusão da operação. Em seguida, atualize a página do repositório no GitHub e verifique se os arquivos do projeto agora aparecem.

Verifique o repositório conectado e a branch selecionada no Atoms.

Verifique o repositório privado e os arquivos do projeto no GitHub.

Mantenha o Atoms e o GitHub sincronizados

Atoms e GitHub não permanecem sincronizados automaticamente. Quando alterações tiverem sido feitas em um dos lados, use os controles de sincronização para mover essas alterações para o outro.

Ação	Use quando	O que acontece
Push Changes	Você fez alterações no Atoms e quer enviá-las para o GitHub.	O Atoms envia os arquivos atuais do projeto para a branch selecionada no GitHub.
Pull Updates	Foram feitas alterações na branch selecionada no GitHub e você quer trazê-las para o Atoms.	O Atoms atualiza o projeto com as alterações mais recentes do GitHub.

Antes de enviar ou puxar alterações, aguarde o Agente terminar e certifique-se de que você está visualizando a versão mais recente do projeto no Chat. Se você abriu uma versão mais antiga em History, volte para o cartão da versão mais recente na parte inferior do Chat e então reabra GitHub.

Se você não estiver na versão mais recente, o Atoms exibirá You must be on the latest version to pull updates or push changes.

Antes de sincronizar, verifique também se a branch selecionada é a que você deseja atualizar.

Se tanto o Atoms quanto o GitHub contiverem alterações que você precisa manter, ainda não os sincronize. Salve primeiro uma cópia do trabalho importante ou peça a alguém familiarizado com GitHub para preservar as alterações em uma branch separada.

Se Repository Status mostrar Upstream Changes Available, o GitHub contém alterações que o Atoms ainda não tem. Revise o repositório antes de escolher uma ação.

Use Pull Updates e Push Changes para a branch selecionada.

Envie alterações do Atoms para o GitHub

1. Termine de fazer suas alterações no Atoms e aguarde o Agente parar de trabalhar.
2. Certifique-se de que você está visualizando a versão mais recente do projeto.
3. Abra Settings → Connectors → GitHub e verifique se a branch correta está selecionada.
4. Selecione Push Changes.
5. Mantenha a página aberta enquanto as alterações estão sendo enviadas.
6. Quando Changes pushed successfully aparecer, selecione View on GitHub e verifique se os arquivos mais recentes do projeto estão lá.

Push Changes está disponível somente quando o Atoms tem alterações que ainda não foram enviadas ao GitHub. Ele fica indisponível enquanto o Agente está trabalhando ou quando você está visualizando uma versão mais antiga do projeto.

Depois que você selecionar Push Changes, as alterações serão enviadas ao GitHub imediatamente, sem pedir confirmação. Se o mesmo arquivo tiver sido alterado tanto no Atoms quanto no GitHub, a versão no Atoms terá prioridade e substituirá a versão atualmente armazenada no GitHub.

Puxe atualizações do GitHub para o Atoms

Ao contrário do envio, puxar alterações exige confirmação primeiro. Se o mesmo arquivo tiver sido alterado tanto no GitHub quanto no Atoms, a versão do GitHub terá prioridade e substituirá a versão atual no Atoms.

1. Abra Settings → Connectors → GitHub.
2. Verifique se Repository Status mostra novas alterações do GitHub e se a branch correta está selecionada.
3. Selecione Pull Updates.
4. Leia o aviso Pull May Affect Project. Se você quiser trazer as alterações do GitHub para seu projeto atual no Atoms, selecione Confirm.
5. Mantenha a página aberta enquanto as alterações estão sendo puxadas.
6. Quando Changes pulled successfully aparecer, abra o Visualizador de App e teste as partes do seu projeto afetadas pelas alterações para garantir que tudo ainda funcione como esperado.

Pull Updates está disponível somente quando a branch selecionada do GitHub contém alterações que ainda não foram trazidas para o Atoms.

Desconectar GitHub

Desconecte o GitHub quando não quiser mais que o Atoms acesse a conta conectada. O repositório do GitHub e seus arquivos permanecerão no GitHub, mas o Atoms não poderá mais enviar nem puxar alterações.

A autorização do GitHub se aplica à conta conectada. Revogar o acesso desconecta todos os projetos do Atoms que usam essa conta do GitHub, então verifique seus outros projetos antes de continuar.

1. Abra Settings → Connectors → GitHub.
2. Selecione Disconnect.
3. Na confirmação Disconnect GitHub, selecione Disconnect novamente.
4. O GitHub deve abrir automaticamente a página de autorização relevante. Se isso não acontecer, no GitHub vá para Settings → Applications → Authorized OAuth Apps.
5. Encontre Atoms, selecione ... à direita da linha correspondente e depois selecione Revoke. Não selecione Revoke all; essa ação remove o acesso de todos os apps OAuth autorizados listados na página.
6. Siga quaisquer etapas de confirmação necessárias no Github.
7. Volte ao Atoms e reabra o conector do GitHub para confirmar que a conta não está mais conectada.

Selecione Disconnect no conector do GitHub.

Revogue apenas a aplicação OAuth do Atoms no GitHub.