O que é o GitHub? Controle de versão para quem não é programador

O GitHub é um site que guarda o código de projetos de software junto com todo o seu histórico, para que você possa ver cada mudança, desfazer erros e trabalhar no mesmo projeto com outras pessoas. Ele é baseado no Git, um software gratuito que registra “fotografias” dos arquivos de um projeto ao longo do tempo. O Git é a ferramenta que mantém o histórico; o GitHub é a casa online onde esse histórico é compartilhado, copiado para backup e discutido.

Se você cria apps com IA, o GitHub serve basicamente para duas coisas: ter uma cópia do seu código fora da ferramenta em que ele foi criado e entregá-lo a um desenvolvedor no formato que ele já usa no dia a dia.

Por que isso importa quando você cria apps com IA

Uma ferramenta de criação de apps com IA escreve e altera muito código, e nem toda mudança é uma melhoria. O controle de versão é o que deixa esse processo seguro.

• Desfaça sem medo. Cada alteração salva é uma fotografia. Se a IA quebrar algo, você volta para a última versão que funcionava.
• Propriedade. O código na sua conta do GitHub continua sendo seu se você trocar de ferramenta, deixar de pagar por uma delas ou quiser uma segunda opinião.
• Trabalho com desenvolvedores. Quase todo desenvolvedor usa Git todos os dias. Um repositório permite que ele revise o que a IA escreveu, corrija e devolva as alterações.
• Publicação em outro lugar. Muitas plataformas de hospedagem conseguem publicar diretamente a partir de um repositório do GitHub.

Uma analogia do dia a dia: controle de alterações mais uma pasta compartilhada

Pense em um documento com o modo de controle de alterações ligado, guardado em uma pasta compartilhada.

• O Git é o controle de alterações: cada edição fica registrada, com quem fez, quando e por quê, e você pode voltar a qualquer versão.
• O GitHub é a pasta compartilhada: o documento fica online, outras pessoas podem pegar uma cópia e há um lugar para comentar e aprovar.
• Um branch (ramificação) é como salvar uma cópia chamada “rascunho — nova seção de preços” para testar algo sem mexer na versão que todos usam. Se o teste der certo, você faz o merge de volta.

A diferença em relação a um documento é a escala. Um app tem centenas de arquivos, e o Git acompanha todos juntos, então uma fotografia é o estado do projeto inteiro de uma só vez.

Termos de Git e GitHub que você vai encontrar

Dois pontos merecem destaque. Primeiro, o histórico do Git é permanente por design: se uma senha for commitada e enviada, apagá-la em um commit posterior não a remove do histórico. Segundo, um commit só é útil na medida da sua mensagem. “Corrige contagem dupla de reservas quando duas pessoas reservam ao mesmo tempo” ajuda você depois; “atualiza” não ajuda.

Um exemplo prático: entregar um app criado com IA a um freelancer

Você criou um portal de clientes com uma ferramenta de criação de apps com IA. Ele funciona, mas você quer que um desenvolvedor freelancer adicione uma integração complicada com o seu software de contabilidade.

1. Conecte o projeto a um novo repositório privado do GitHub e envie (push) o código. O repositório agora guarda o código e o seu histórico.
2. Confira o que está nele. Abra o repositório no GitHub. Não deve haver nenhum arquivo .env nem chaves de API no código. Os segredos ficam nas configurações da sua plataforma e são compartilhados com o freelancer separadamente, se for o caso — veja variáveis de ambiente e segredos.
3. Convide o freelancer como colaborador apenas desse repositório.
4. Ele trabalha em um branch com um nome como sincronizacao-contabil, faz commits ao longo do caminho e abre um pull request quando termina.
5. Você revisa o pull request. Mesmo sem ler código, dá para ler a descrição, ver quais arquivos mudaram e fazer perguntas nos comentários.
6. Faça o merge quando estiver satisfeito e depois puxe (pull) as mudanças de volta para a sua ferramenta de criação, para que você e a IA continuem a partir da nova versão.

No caminho, você consegue ver exatamente o que mudou e desfazer, se necessário. Esse é o valor completo do controle de versão em um único fluxo de trabalho. Se você ainda está avaliando se deve contratar um desenvolvedor, veja contratar um desenvolvedor ou criar com IA.

Erros comuns e ideias equivocadas

• “GitHub e Git são a mesma coisa.” O Git funciona sem o GitHub; alternativas como GitLab e Bitbucket também hospedam repositórios Git.
• “O GitHub vai executar meu app.” O GitHub armazena código. Rodar o app para o público é hospedagem web, um serviço separado (embora alguns provedores publiquem a partir do GitHub).
• Fazer commit de segredos. É o erro mais prejudicial e mais comum. Use o .gitignore para arquivos .env e troque qualquer chave que tenha sido enviada alguma vez.
• Só um branch e nenhuma mensagem. Serve para experimentos solo, mas dê mensagens claras aos commits e use branches para qualquer coisa arriscada.
• Editar em dois lugares ao mesmo tempo. Se você altera o código no GitHub e na sua ferramenta de IA sem sincronizar entre as duas, cria conflitos. Escolha um lugar para editar por vez e sincronize antes de trocar.
• Achar que um repositório privado é um backup de tudo. Ele guarda código, não o conteúdo do seu banco de dados nem os arquivos enviados. Esses precisam de backups próprios.

O que pedir à sua ferramenta de IA

• “Adicione um .gitignore que exclua .env, pastas de dependências e a saída do build.”
• “Escreva um README que explique como instalar, quais variáveis de ambiente são necessárias (só os nomes) e como rodar o app.”
• “Adicione um .env.example com todos os nomes de variáveis e nenhum valor real.”
• “Use mensagens de commit claras e descritivas para cada mudança.”

Esses quatro pedidos criam um repositório que um desenvolvedor consegue assumir em poucos minutos. Para levar o app para os seus próprios servidores, veja como exportar e hospedar você mesmo um app criado com IA, e para deixá-lo pronto para usuários reais, como levar um protótipo de IA para produção.

GitHub e Mythex

O Mythex mantém o histórico para você em todos os planos: depois de cada turno bem-sucedido do agente, ele salva um checkpoint, que é uma fotografia Git para a qual você pode voltar. No plano Pro, você pode conectar o GitHub e enviar ou puxar o projeto com o seu próprio repositório, ou baixar o projeto inteiro como um arquivo compactado; segredos e dependências instaladas ficam fora das exportações. Aqui, o GitHub serve para sincronizar código, não para fazer login no Mythex. Veja GitHub, exportação e importação na documentação e a página de preços para saber o que cada plano inclui.

Perguntas