Branches, remotes e a barra lateral

Uma única barra lateral, reordenável e pesquisável, guarda branches, remotes, tags, stashes, worktrees e submódulos. Toda seção pode ser escondida ou reordenada (Configurações → Layout), e a caixa de filtro vale para todas elas. Quais seções e pastas você deixa abertas ou fechadas fica lembrado por repositório, mesmo depois de reiniciar.

A barra lateral é uma pilha de painéis, não uma lista longa. Uma seção aberta ocupa a altura que as recolhidas deixam — elas ficam abaixo como linhas de cabeçalho. Abra várias e elas partilham essa altura em partes iguais, cada uma com o próprio scroll. Uma seção com centenas de tags rola dentro do seu painel e os outros cabeçalhos ficam onde estão, então nada que você queira clicar sai da tela. Abra mais do que cabe e todos os painéis encolhem juntos até o cabeçalho — a barra lateral em si nunca rola.

Só Local começa aberta num repositório que você ainda não arrumou; cada outra seção começa como cabeçalho. Uma seção com mais de 300 refs começa recolhida mesmo assim. Num repositório com milhares de branches remotos que ninguém nunca apagou, todos estariam na tela sem você ter pedido; abra uma vez e essa escolha é lembrada como qualquer outra.

Branches

Criar, fazer checkout, renomear e apagar — locais e remotas. As linhas de branch mostram:

• ↑à frente / ↓atrás em relação ao upstream delas,
• selos de presença por remote (quais remotes têm esta branch),
• um ponto de risco depois de uma varredura do radar de conflitos,
• um marcador ⟳ quando o remote reescreveu o histórico.

Branches com / no nome se dobram automaticamente em pastas colapsáveis. Um prefixo com um filho só continua pasta — release/1.2.3 é release com 1.2.3 dentro — então acrescentar release/1.2.4 depois não redesenha a árvore. Uma sequência de pastas de um filho só vira um cabeçalho (dependabot/npm_and_yarn). Cabeçalhos de pasta levam marca de pasta; a ref, marca de branch, remoto ou tag.

Clique com o botão direito no cabeçalho de uma pasta para agir sobre o grupo inteiro: Excluir todas as branches em feature (4 branches) remove tudo o que há dentro após uma única confirmação que lista exatamente quais branches se vão — a branch em que você está fica de fora. O mesmo menu existe nas pastas de branches remotas, excluindo do remote.

O menu suspenso de branches na barra de ferramentas lista branches locais e remotos. Clique com o botão direito em qualquer branch desse menu para renomear um branch local, copiar seu nome, abri-lo em um novo worktree, mesclá-lo no branch ativo ou excluí-lo. Branches remotos omitem a renomeação e são excluídos do remoto após confirmação. O Gitcito omite a mesclagem quando a referência selecionada já está contida no branch ativo e desativa a criação de worktree quando esse branch já está em checkout.

As linhas se selecionam em grupo como arquivos: clique com ⌘/Ctrl alterna uma linha, clique com Shift seleciona um intervalo, e Shift+↑/↓ amplia a seleção a partir da última linha clicada. Clique com o botão direito na seleção para o menu em lote — Excluir 4 branches — que confirma com a lista completa. Os mesmos gestos funcionam em branches remotas, tags e stashes.

Renomeando uma branch

Uma branch chamada fix três dias atrás é uma branch que hoje ninguém situa. Renomeie de onde você percebeu o problema:

Uma renomeação local é git branch -m: instantânea e desfazível com ⌘Z — a entrada de desfazer devolve o nome antigo. Renomear a branch em que você está mantém você nela.

Quando a branch acompanha um remoto, o menu também oferece Renomear (incl. no remoto)…, que renomeia localmente, envia o nome novo e apaga o antigo no remoto. Isso não é desfazível — a branch remota antiga se foi, e quem a tinha em checkout precisa reapontar. Num selo do grafo, só aparece quando a branch acompanha exatamente um remoto; com vários, escolha a branch na barra lateral para o upstream ficar inequívoco.

Limites: o Gitcito não reescreve nada que referenciava o nome antigo — pull requests abertos continuam apontando para a branch com que foram abertos, e regras de CI que casam com um padrão de branch deixam de casar. Renomear uma branch que está em checkout em outro worktree falha, e o git diz isso.

Pull e push de uma branch em que você não está

Clique com o botão direito em qualquer branch local: as entradas Pull e Push agem sobre aquela branch, não sobre a que está em checkout — sem desvio para colocar três branches em dia. Veja fetch, pull e push.

Branches fixadas

Marque com estrela as branches às quais você sempre volta — passe o mouse na linha e clique em ★, ou clique com o botão direito → Fixar branch. Elas aparecem num grupo Fixadas no topo da seção Locais, lembradas por repositório, sem sair do lugar normal delas mais abaixo.

Fazendo checkout de uma branch remota

Dê duplo clique numa branch remota para criar a branch local que a rastreia. Se uma branch local com esse nome já existir e tiver divergido, o Gitcito pergunta como reconciliar — rebase, merge ou reset — e oferece fazer backup da branch antes.

Quando seu branch local está atrás

Ele é avançado (fast-forward) até a ponta do remoto durante o checkout. Uma árvore de trabalho suja vai para um stash nomeado e é restaurada depois, para que suas edições locais não abortem a atualização.

Quando seu branch local está à frente

Se o branch local está à frente e o remoto não tem nada novo, fazer checkout responderia a um pedido pelo branch remoto com o seu próprio trabalho não enviado — então nada é trocado até você dizer de que lado estava falando:

Deixe Criar antes um branch de backup marcado e a ponta local é salva como backup/<branch>-<carimbo-de-tempo> antes de qualquer movimento, de modo que até um reset hard fica a um checkout de ser desfeito. O reset também entra na pilha de desfazer (⌘Z), mas só até você fechar o repositório — o branch de backup dura mais.

Limites: o diálogo só compara o branch com a referência de rastreamento recém-buscada, então um remoto que recusou o fetch (offline, credenciais inválidas) é comparado com a última ponta conhecida. Ele não diz se seus commits são bons — apenas que existem aqui e não lá.

Remotes

A seção Remotes da barra lateral é onde remotes são adicionados, editados, buscados e removidos. Fetch, pull ou push num repositório que não tem nenhum abre o mesmo diálogo Adicionar remoto — cole uma URL ou crie o repo no host — em vez de não fazer nada. Veja fetch, pull e push.

Veja também: Merge e rebase · Worktrees