> ## 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.
# Controle de versão
> Aprenda como rastrear alterações e gerenciar o histórico do seu código com as ferramentas de controle de versão do 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 Git integrada 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 trabalho perdido
* 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 é alimentado pelo Git — a ferramenta padrão da indústria 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. **Checkpoints do Agent** criam commits automaticamente em marcos importantes ao construir com o [Replit Agent](/references/agent/overview). [Saiba mais sobre checkpoints e rollbacks](/references/version-control/checkpoints-and-rollbacks).
2. **Painel Git** fornece acesso visual ao repositório Git completo
3. **Git CLI** oferece acesso por linha de comando a toda a funcionalidade do Git
4. **Histórico de arquivos** rastreia alterações granulares dentro de arquivos individuais
Escolha a interface que melhor corresponde às suas necessidades, com a confiança de que tudo é suportado pelo robusto sistema de controle de versão do Git.
| Recurso | Checkpoints do Agent | Commits Git | Histórico de arquivos |
| ---------------------------- | ------------------------------------------------- | ------------------------------------------------- | -------------------------------- |
| **Criação** | Automática em pontos lógicos | Manual ou agendada | Automática |
| **Granularidade** | Alterações no nível de recurso | Qualquer tamanho de alteração | Alterações no nível de caractere |
| **Descrição** | Resumos gerados por IA | Mensagens escritas pelo usuário | Timestamps 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 de sincronização completas com GitHub | Capacidades de sincronização completas com GitHub | Sem sincronização com GitHub |
## Primeiros passos
Acesse o controle de versão no seu Replit App adicionando a ferramenta Git ao Editor de Projeto:
1. Navegue até a seção Ferramentas 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, veja [Importar do GitHub](/build/import-from-github).
## Opções de controle de versão
O controle de versão do Replit é alimentado pelo Git em seu núcleo. Você tem várias maneiras de interagir e se beneficiar do controle de versão:
### Controle de versão automático
Instantâneos automáticos criados durante o desenvolvimento assistido por IA com o [Replit Agent](/references/agent/overview).
**Ideal para**: Desenvolvimento com o Replit Agent
**Capacidades principais**:
* Criação automática em marcos lógicos
* Rollback com um clique
* Instantâneos no 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 Painel Git ou Git CLI. Você também pode visualizar todos os seus checkpoints usando o recurso Histórico, que fornece:
* Visualização cronológica dos checkpoints
* Descrições detalhadas dos 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 não realizadas pelo Agent feitas diretamente no editor.
**Ideal para**: Recuperação rápida de alterações recentes em arquivos
**Capacidades principais**:
* Foco em arquivo único
* Alterações no nível de caractere
* Comparação visual
* Histórico de 30 dias
* Recurso de reprodução
Embora o Histórico de Arquivos forneça sua própria interface, as alterações subjacentes fazem parte do histórico do Git. Saiba mais sobre [Histórico de Arquivos](/references/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.
**Ideal para**: A maioria dos projetos que requerem integração com GitHub e fluxo de trabalho visual
**Capacidades principais**:
* Rastreamento em todo o repositório
* Gerenciamento de branches
* Visualização de diffs
* Sincronização com GitHub com um clique
* Colaboração em equipe
Para instruções detalhadas sobre como usar o painel Git, veja [Usando o painel Git](/references/version-control/git-interface).
Acesso completo por linha de comando ao Git através do [Shell](/references/editor/shell) para operações avançadas.
**Ideal para**: Usuários avançados que precisam de funcionalidade Git completa
**Capacidades principais**:
* 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, veja [Usando o painel Git](/references/version-control/git-interface#using-git-commands-in-shell).
## Recursos principais
* **Interface Git visual**: Gerencie repositórios, commits e branches sem digitar comandos Git
* **Integração com GitHub**: Conecte-se a repositórios GitHub para backup e colaboração
* **Importar do GitHub**: Transforme qualquer [repositório GitHub em um Replit App](/build/import-from-github) com alguns cliques
* **Gerenciamento de branches**: Crie, alterne entre e mescle branches diretamente no Editor de Projeto
* **Resolução de conflitos**: Identifique e resolva conflitos de merge com assistência visual
## Casos de uso
**Rastreando seus projetos pessoais**
Acompanhe as alterações no seu código à medida que desenvolve, permitindo reverter para versões anteriores se necessário. O [painel Git](/references/version-control/git-interface) mostra suas alterações visualmente, facilitando o commit de atualizações significativas.
**Colaborando com uma equipe**
Trabalhe com múltiplos desenvolvedores no mesmo código sem sobrescrever as alterações uns dos outros. Crie branches para novos recursos e depois mescle-os quando estiverem prontos. Saiba mais sobre [convidar colegas](/build/invite-teammates).
## Checkpoints do Agent
Ao criar aplicativos com o [Replit Agent](/references/agent/overview), 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 conteúdo do projeto, contexto de conversa com 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 instantâneos abrangentes de todo o estado 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 conteúdo do projeto, memória de IA e 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 oferecem vantagens únicas ao construir com IA:
* **Rede de segurança**: Experimente com confiança sabendo que você pode facilmente restaurar 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 contexto de IA
Para informações detalhadas sobre o que os checkpoints capturam e capacidades abrangentes de rollback, veja [Checkpoints e Rollbacks](/references/version-control/checkpoints-and-rollbacks).
Embora os checkpoints do Agent sejam poderosos para desenvolvimento com IA, considere usar commits Git para rastreamento de versão de 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, veja os seguintes recursos:
* [Usando o painel Git](/references/version-control/git-interface): Domine a interface Git visual do Replit
* [Importar do GitHub](/build/import-from-github): Transforme repositórios GitHub em Replit Apps
* [Convidar colegas](/build/invite-teammates): Trabalhe com outros em projetos compartilhados
* [Histórico de Arquivos](/references/version-control/file-history): Explore o histórico de versões no nível de arquivo
* [Replit Agent](/references/agent/overview): Saiba mais sobre desenvolvimento assistido por IA