Git

Git na barra do painel#

Quando um painel está dentro de um repositório, a barra superior mostra a branch atual, quantos commits ela está à frente (↑) e atrás (↓), e quantos arquivos mudaram. Ao lado disso:

Nome da branch

Abre a lista de branches: primeiro as locais, depois as que só existem no remoto. Clique em uma branch (ou pressione Enter) para mudar para ela. Digite um nome que não existe e pressione Enter para criar a branch e mudar para ela. Branches em checkout em outro worktree aparecem marcadas e não podem ser escolhidas.

Diff

Abre as mudanças sem commit da pasta deste painel, sem abrir a janela do Git.

Worktree

Cria um worktree para este repositório. Veja Worktrees.

Commit

Abre o status dos arquivos na janela do Git com a caixa de mensagem em foco.

Fetch / Pull / Push

O Pull fica destacado quando há algo para puxar. Sem upstream, ele puxa da branch padrão do remoto (por exemplo origin/main); a dica mostra a origem. O Push aparece quando você tem commits não enviados.

A janela do Git#

Clique em Git na barra de ferramentas ou pressione Cmd/Ctrl+E para abrir a janela do Git do repositório do terminal em foco. O selo na barra de ferramentas mostra quantos arquivos mudaram. Feche com Esc, com o botão × ou com Cmd/Ctrl+E de novo. Arraste as bordas para redimensionar; clique duas vezes em uma alça para restaurar.

O lado esquerdo alterna entre Status dos arquivos, Histórico, Pesquisar, worktrees, issues e pull requests, e lista Branches (agrupadas em pastas por /), Remotos e Tags. Clique em uma referência para ver o commit dela no Histórico; clique duas vezes em uma branch para fazer checkout.

Revisar e fazer commit das mudanças#

1. Abra a janela do Git. Ela começa em Status dos arquivos, listando cada arquivo sem commit com o status e a contagem de linhas.
2. Clique em um arquivo para ver o diff com números de linha. Desmarque os arquivos que você não quer neste commit.
3. Escreva uma mensagem em Mensagem do commit. Marque Fazer push após o commit para enviar na hora.
4. Clique em Commit ou pressione Cmd/Ctrl+Enter.

Todas as alterações abre o diff completo da árvore de trabalho em um visualizador maior. Lá as linhas longas quebram, e você pode arrastar a borda da lista de arquivos para alargá-la.

Navegar pelo histórico#

O Histórico desenha um grafo de commits com todas as branches locais e remotas e as tags. Selecione um commit para ver os arquivos e o patch logo abaixo. Pesquisar filtra por mensagem, autor ou hash.

Clique com o botão direito em um commit → Voltar até este commit... redefine a branch para ele. Os commits posteriores saem do histórico atual e as mudanças sem commit em arquivos rastreados são descartadas (arquivos não rastreados ficam), por isso o app pede confirmação antes.

Pull, push, fetch e stash#

Pull

Escolha qual branch remota puxar para a atual, sem trocar de branch.

Push

Envia a branch atual e define o upstream dela no primeiro push.

Fetch

Busca as atualizações de todos os remotos.

Stash

Guarda as mudanças no stash, inclusive arquivos não rastreados (git stash push -u).

Quando o Git não consegue rodar#

Se algo no seu computador impede o git de funcionar, o PATerminal explica o motivo e mostra a correção em uma linha, com Digitar no terminal para inseri-la (você pressiona Enter) ou Copiar. Ele reconhece licença do Xcode não aceita, Command Line Tools ausentes, Git não instalado, pasta de outro usuário (“dubious ownership”) e os limites de caminhos longos do Windows.