Git é um sistema que salva o histórico de tudo que você faz no seu projeto. Pense nele como um "Ctrl+Z infinito com etiquetas" — você pode voltar a qualquer versão anterior do seu código a qualquer momento.

Para engenheiros e arquitetos: é como ter todas as revisões de um projeto (Rev A, Rev B, Rev C...) organizadas automaticamente, sem precisar renomear arquivos.

ℹ️

O Git funciona igual no Antigravity IDE e no VS Code — a interface de controle de versões é a mesma nos dois, pois o Antigravity é um fork do VS Code.

---

Instalação

• Download: git-scm.com/download/win
• Instale com as opções padrão — não precisa mudar nada
• Verifique: abra o PowerShell e rode git --version

---

Conceitos fundamentais (sem enrolação)

Termo	O que significa na prática
Repositório (repo)	A pasta do projeto com o histórico salvo pelo Git
Commit	Um "save" com descrição do que foi feito (como uma revisão do projeto)
Branch	Uma linha paralela de desenvolvimento (ex: testar algo sem afetar o principal)
Merge	Juntar uma branch de volta à principal
GitHub / GitLab	Serviços online para guardar e compartilhar repositórios
Push	Enviar seus commits para o repositório online
Pull	Baixar commits novos do repositório online
Clone	Baixar um repositório completo pela primeira vez

---

Fluxo básico do dia a dia

Você faz alterações nos arquivos
         ↓
git add . (marca os arquivos para salvar)
         ↓
git commit -m "descrição do que foi feito"
         ↓
git push (envia para o GitHub, opcional)

---

Comandos essenciais no terminal

Configuração inicial (faça uma vez só)

git config --global user.name "Seu Nome"
git config --global user.email "seu@email.com"

Iniciar um projeto novo com Git

# Dentro da pasta do projeto:
git init

Salvar o progresso (commit)

# Ver o que mudou
git status

# Marcar todos os arquivos modificados
git add .

# Salvar com descrição
git commit -m "adiciona script de leitura IFC"

Ver o histórico

git log --oneline

Voltar para uma versão anterior (sem apagar nada)

# Copie o código do commit que quer ver (ex: a3f5c12)
git checkout a3f5c12

# Para voltar ao estado atual:
git checkout main

Trabalhar com GitHub

# Conectar seu projeto local a um repositório do GitHub
git remote add origin https://github.com/seu-usuario/seu-repositorio.git

# Enviar pela primeira vez
git push -u origin main

# Enviar depois (mais simples)
git push

# Baixar atualizações
git pull

---

Usando Git pelo Antigravity IDE e VS Code (sem digitar comandos)

Tanto o Antigravity quanto o VS Code têm uma interface visual para o Git — você não precisa digitar nada no terminal.

Como acessar

• Clique no ícone de ramificação na barra lateral esquerda (parece três bolinhas conectadas)
• Ou use o atalho: Ctrl + Shift + G

Fazer um commit pela interface

1. Faça alterações em qualquer arquivo
2. Abra o painel do Git (Ctrl + Shift + G)
3. Você verá os arquivos modificados listados em "Changes"
4. Clique no + ao lado de cada arquivo (ou no + geral para marcar todos) → eles vão para "Staged Changes"
5. Digite uma mensagem descrevendo o que foi feito
6. Clique em ✔ Commit

Enviar para o GitHub (push) pela interface

• Após o commit, clique em "Sync Changes" ou no botão ↑ Push
• Se aparecer uma janela pedindo login no GitHub, faça login com sua conta

Ver o histórico visualmente

• Instale a extensão GitLens (disponível para VS Code e Antigravity)
• Ela adiciona visualização completa do histórico, quem alterou cada linha e quando

---

Exemplos de uso no dia a dia do trabalho

Exemplo 1 — Salvando o progresso de um script

Você acabou de fazer o script leitura_ifc.py funcionar. Hora de salvar:

git add leitura_ifc.py
git commit -m "script leitura_ifc funcionando para arquivos até 500 elementos"

Agora se você estragar tudo tentando melhorar, é só voltar a este ponto.

Exemplo 2 — Testando uma mudança arriscada sem medo

Você quer tentar uma abordagem diferente mas tem medo de quebrar o que já funciona:

# Cria uma branch nova para testar
git checkout -b testar-nova-abordagem

# Faz as alterações e commits normalmente...

# Se funcionar: volta para main e junta
git checkout main
git merge testar-nova-abordagem

# Se não funcionar: abandona a branch e volta para main
git checkout main
# O código principal não foi tocado

Exemplo 3 — Compartilhando um script com a equipe

Você criou um script útil e quer que seu colega use também:

1. Crie um repositório no github.com
2. No terminal da pasta do projeto:

git remote add origin https://github.com/seu-usuario/scripts-bim.git
git push -u origin main

1. Envie o link para seu colega — ele roda:

git clone https://github.com/seu-usuario/scripts-bim.git

Exemplo 4 — Pedindo ao agente para fazer commits por você

No Antigravity ou Gemini CLI, você pode pedir:

Faça um commit com uma mensagem descritiva para as alterações que fizemos hoje no script leitura_ifc.py

Ou no fluxo de execução:

Após cada etapa concluída, faça um commit automático com uma mensagem descritiva do que foi feito

---

Boas mensagens de commit

Uma boa mensagem de commit descreve o que foi feito e por quê (quando não é óbvio).

❌ Ruim	✅ Bom
atualização	corrige leitura de elementos IFC sem GUID
mudei coisas	adiciona exportação de planilha com filtro por tipo
arrumei bug	corrige erro quando arquivo IFC está vazio
v2	refatora função de leitura para suportar IFC4

💡

Regra prática: se você não sabe o que escrever na mensagem do commit, é porque provavelmente fez muita coisa de uma vez. Faça commits menores e mais frequentes.