> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Version control
> Aprenda a rastrear alterações e gerenciar o histórico do seu código com as ferramentas de controle de versão da Replit.
O controle de versão no Replit permite que você rastreie, gerencie e colabore no seu código com confiança. Com integração nativa ao Git e conectividade com o GitHub, você pode:
* Rastrear alterações de código e manter um histórico do seu trabalho de desenvolvimento
* Colaborar com membros da equipe sem conflitos de código ou perda de trabalho
* Importar, modificar e enviar código entre o Replit e o GitHub
* Trabalhar com branches para experimentar novos recursos com segurança
## O que é controle de versão?
Controle de versão é um sistema que registra alterações em arquivos ao longo do tempo, permitindo que você recupere versões específicas posteriormente. No Replit, o controle de versão é baseado no Git — a ferramenta padrão do setor para rastrear alterações de código — com uma interface visual amigável que elimina a necessidade de conhecimento de linha de comando.
### Como o controle de versão funciona no Replit
Todas as quatro opções de controle de versão interagem com o mesmo repositório Git subjacente:
1. **Agent Checkpoints** criam commits automaticamente em marcos importantes ao construir com o [Replit Agent](/core-concepts/agent). [Saiba mais sobre checkpoints e rollbacks](/core-concepts/agent/checkpoints-and-rollbacks).
2. **Git Pane** fornece acesso visual ao repositório Git completo
3. **Git CLI** oferece acesso por linha de comando a toda a funcionalidade Git
4. **File History** rastreia alterações granulares em arquivos individuais
Escolha a interface que melhor atende às suas necessidades, com a confiança de que tudo é respaldado pelo robusto sistema de controle de versão do Git.
| Recurso | Agent Checkpoints | Git Commits | File History |
| ---------------------------- | ------------------------------------------------- | ------------------------------------------------- | --------------------------------- |
| **Criação** | Automática em pontos lógicos | Manual ou agendada | Automática |
| **Granularidade** | Alterações em nível de recurso | Qualquer tamanho de alteração | Alterações em nível de caractere |
| **Descrição** | Resumos gerados por IA | Mensagens escritas pelo usuário | Carimbos de data/hora automáticos |
| **Rollback** | Restauração com um clique | Requer conhecimento de Git | Restauração com um clique |
| **Capacidades Git** | Capacidades Git completas | Capacidades Git completas | Sem capacidades Git |
| **Sincronização com GitHub** | Capacidades completas de sincronização com GitHub | Capacidades completas de sincronização com GitHub | Sem sincronização com GitHub |
## Primeiros passos
Acesse o controle de versão no seu Replit App adicionando a ferramenta Git ao Project Editor:
1. Navegue até a seção Tools no seu Replit App
2. Selecione o sinal **+** para adicionar novas ferramentas
3. Selecione **Git** na lista de ferramentas disponíveis
Para importar projetos existentes do GitHub, consulte [Importar do GitHub](/getting-started/quickstarts/import-from-github).
## Opções de controle de versão
O controle de versão da Replit é baseado no Git em seu núcleo. Você tem várias maneiras de interagir com o controle de versão e se beneficiar dele:
### Controle de versão automático
Snapshots automáticos criados durante o desenvolvimento assistido por IA com o [Replit Agent](/core-concepts/agent).
**Melhor para**: Desenvolvimento com o Replit Agent
**Principais capacidades**:
* Criação automática em marcos lógicos
* Rollback com um clique
* Snapshots em nível de recurso
* Rastreamento de progresso
* Sem necessidade de configuração
* Linha do tempo visual do progresso de desenvolvimento
Os checkpoints do Agent são armazenados no Git e podem ser acessados pelo Git Pane ou pelo Git CLI. Você também pode visualizar todos os seus checkpoints usando o recurso History, que fornece:
* Visualização cronológica de checkpoints
* Descrições detalhadas de checkpoints
* Acesso direto aos estados dos checkpoints
* Rollback com um clique para qualquer checkpoint
Rastreamento de versão por arquivo com salvamento automático para alterações feitas diretamente no editor (não pelo Agent).
**Melhor para**: Recuperação rápida de alterações recentes em arquivos
**Principais capacidades**:
* Foco em um único arquivo
* Alterações em nível de caractere
* Comparação visual
* Histórico de 30 dias
* Recurso de reprodução
Embora o File History forneça sua própria interface, as alterações subjacentes fazem parte do histórico do Git. Saiba mais sobre o [File History](/core-concepts/project-editor/version-control/file-history).
### Interfaces baseadas em Git
Uma interface visual para operações Git que torna o controle de versão acessível sem conhecimento de linha de comando.
**Melhor para**: A maioria dos projetos que requerem integração com GitHub e fluxo de trabalho visual
**Principais capacidades**:
* Rastreamento em nível de repositório
* Gerenciamento de branches
* Visualização de diff
* Sincronização com GitHub com um clique
* Colaboração em equipe
Para instruções detalhadas sobre como usar o Git Pane, consulte [Usando o Git Pane](/core-concepts/project-editor/version-control/git-interface).
Acesso completo por linha de comando ao Git através do [Shell](/core-concepts/project-editor/editor-and-tools/shell) para operações avançadas.
**Melhor para**: Usuários avançados que precisam de funcionalidade Git completa
**Principais capacidades**:
* Conjunto completo de comandos Git
* Estratégias avançadas de branching
* Fluxos de trabalho personalizados
* Automação de scripts
* Controle completo do repositório
Para comandos Git comuns e uso, consulte [Usando o Git Pane](/core-concepts/project-editor/version-control/git-interface#using-git-commands-in-shell).
## Principais recursos
* **Interface Git visual**: Gerencie repositórios, commits e branches sem digitar comandos Git
* **Integração com GitHub**: Conecte-se a repositórios do GitHub para backup e colaboração
* **Importar do GitHub**: Transforme qualquer [repositório do GitHub em um Replit App](/getting-started/quickstarts/import-from-github) com poucos cliques
* **Gerenciamento de branches**: Crie, alterne entre e mescle branches diretamente no Project Editor
* **Resolução de conflitos**: Identifique e resolva conflitos de merge com assistência visual
## Casos de uso
**Rastreando seus projetos pessoais**
Rastreie alterações no seu código conforme você desenvolve, permitindo reverter para versões anteriores se necessário. O [Git Pane](/core-concepts/project-editor/version-control/git-interface) mostra suas alterações visualmente, facilitando o commit de atualizações significativas.
**Colaborando com uma equipe**
Trabalhe com vários desenvolvedores no mesmo código sem sobrescrever as alterações uns dos outros. Crie branches para novos recursos e então mescle-os quando estiver pronto. Saiba mais sobre [convidar membros da equipe](/replitai/invite-teammates).
## Checkpoints do Agent
Ao construir aplicativos com o [Replit Agent](/core-concepts/agent), você se beneficia de uma camada adicional de controle de versão por meio de checkpoints. Os checkpoints capturam automaticamente o estado abrangente do seu projeto — incluindo o conteúdo do projeto, o contexto da conversa com a IA e bancos de dados conectados — em momentos-chave durante o desenvolvimento assistido por IA.
### Como os checkpoints funcionam
Os checkpoints do Agent funcionam como snapshots abrangentes do estado completo do seu Replit App:
* **Criação automática**: O Agent cria checkpoints em pontos lógicos durante o desenvolvimento
* **Captura de estado completo**: Cada checkpoint preserva o conteúdo do projeto, a memória da IA e os estados do banco de dados
* **Planos de implementação**: Antes de fazer alterações, o Agent apresenta um plano para sua revisão
* **Rastreamento de tarefas complexas**: Múltiplos checkpoints podem ser criados para tarefas maiores
### Benefícios para o desenvolvimento assistido por IA
Os checkpoints do Agent fornecem vantagens únicas ao construir com IA:
* **Rede de segurança**: Experimente com confiança sabendo que pode restaurar facilmente estados anteriores em todo o seu ambiente de desenvolvimento
* **Rastreamento de progresso**: Veja exatamente como o Agent construiu seu aplicativo passo a passo
* **Marcos lógicos**: Os checkpoints representam recursos completos em vez de pontos de salvamento arbitrários
* **Rollback instantâneo**: Retorne a qualquer estado anterior com um único clique, incluindo restauração do banco de dados e do contexto da IA
Para informações detalhadas sobre o que os checkpoints capturam e capacidades abrangentes de rollback, consulte [Checkpoints e Rollbacks](/core-concepts/agent/checkpoints-and-rollbacks).
Embora os checkpoints do Agent sejam poderosos para o desenvolvimento com IA, considere usar commits Git para rastreamento de versão a longo prazo e colaboração, especialmente ao trabalhar com repositórios externos.
## Próximos passos
Para saber mais sobre controle de versão no Replit, consulte os seguintes recursos:
* [Usando o Git Pane](/core-concepts/project-editor/version-control/git-interface): Domine a interface Git visual da Replit
* [Importar do GitHub](/getting-started/quickstarts/import-from-github): Transforme repositórios do GitHub em Replit Apps
* [Convidar membros da equipe](/replitai/invite-teammates): Trabalhe com outras pessoas em projetos compartilhados
* [File History](/core-concepts/project-editor/version-control/file-history): Explore o histórico de versões em nível de arquivo
* [Replit Agent](/core-concepts/agent): Saiba mais sobre desenvolvimento assistido por IA