Migre do SourceTree para o GitSquid em 15 minutos

Migre do SourceTree para o GitSquid em 15 minutos

O SourceTree foi a primeira GUI de Git de toda uma geração de desenvolvedores. Era gratuito, tornou o staging visual e, para muitos de nós, foi a ferramenta que finalmente fez o Git fazer sentido. Essa história merece respeito — e é também por isso que sair parece um passo maior do que realmente é. Este guia percorre toda a migração, passo a passo, em cerca de 15 minutos. A etapa mais demorada é criar dois tokens de API.

Transparência: este artigo está publicado no site do GitSquid.

Por que as pessoas deixam o SourceTree

Se você está lendo isto, provavelmente já tem seus motivos. Os quatro que mais ouvimos:

• Sem versão para Linux. O SourceTree roda apenas em macOS e Windows, e isso nunca mudou. Se você migrar para uma máquina Linux — ou se houver um único desenvolvedor Linux na sua equipe — o SourceTree simplesmente não é uma opção ali.
• Desempenho em repositórios grandes. Em repos com milhares de commits, a interface trava: trocar de branch leva segundos, a visão de status dos arquivos se arrasta e um fetch em um repositório grande pode congelar o app por completo.
• Ritmo de lançamentos lento. Atualizações importantes do SourceTree chegam uma ou duas vezes por ano, e relatos de bugs podem ficar meses sem resposta. O app funciona, mas visivelmente não é uma prioridade para a Atlassian.
• A conta Atlassian. Historicamente, o SourceTree exigia registro com uma conta Atlassian ou Bitbucket só para usar um cliente Git local. Para uma ferramenta que basicamente roda git status no seu próprio disco, isso sempre pareceu uma conta a mais.

Nada disso faz do SourceTree uma ferramenta ruim — faz dele uma ferramenta que está envelhecendo. Para uma comparação completa, recurso por recurso, veja GitSquid vs SourceTree em 2026. Este artigo é a metade prática: como fazer a mudança de verdade.

Antes de começar: não há nada para exportar

Aqui está a parte que mais surpreende as pessoas: não existe etapa de migração para os seus repositórios, porque os seus repositórios são apenas pastas no disco. Cada branch, cada commit, cada stash, cada remote, cada hook vive dentro do diretório .git, e é o próprio Git que guarda todo esse estado. O SourceTree nunca foi dono de nada disso — era uma janela para dados que sempre foram seus.

É também por isso que o GitSquid não tem um assistente de "importar favoritos do SourceTree": não há genuinamente nada para importar. A lista de favoritos do SourceTree é só uma lista de caminhos de pastas, e recriá-la leva um minuto (passo 2 abaixo).

Isso também significa que experimentar tem risco zero. Mantenha o SourceTree instalado, aponte o GitSquid para as mesmas pastas e use os dois lado a lado por uma semana. As duas ferramentas executam comandos Git sobre os mesmos dados .git; voltar atrás é só reabrir o outro app.

Passo 1: instale o GitSquid (2 minutos)

Vá até a página de download e baixe a build para a sua plataforma:

• macOS — arm64 nativo, sem a lentidão do Rosetta no Apple Silicon.
• Windows — x64 e ARM64 nativo.
• Linux — x64 e ARM64. Sim, esta é a plataforma em que o SourceTree nunca chegou a existir.

Sem criação de conta, sem tela de login, sem diálogo de consentimento de telemetria. Só isso já é um contraste notável com a primeira execução do SourceTree: você abre o app e está na tela inicial, pronto para abrir um repositório.

Passo 2: reabra os seus repositórios (3 minutos)

A partir da tela inicial, abra as mesmas pastas que você tinha nos favoritos do SourceTree. Se não tiver certeza de onde estão todas, a janela de favoritos do SourceTree mostra o caminho completo de cada repositório — vá descendo por essa lista.

Os repositórios que você abriu aparecem na lista de repos recentes da tela inicial e, depois de 5 repositórios, uma barra de busca aparece acima da lista, então mesmo uma coleção longa de favoritos fica a uma tecla de distância. Cada repositório abre na sua própria aba, e alternar entre abas é quase instantâneo — sem nova varredura, sem ícone girando, o que costuma ser o primeiro momento "opa" para quem usa SourceTree há anos.

Passo 3: credenciais — a única parte chatinha (5 minutos)

Este é o único passo em que alguns minutos de atenção compensam. Há duas camadas separadas, e ajuda mantê-las distintas.

Push e pull: os credential helpers do próprio Git

O GitSquid não mantém um cofre de credenciais próprio. Ele usa os credential helpers do próprio Git — a mesma configuração de osxkeychain, Git Credential Manager ou libsecret que responde quando você roda git push em um terminal. O teste prático: abra um terminal, faça cd em um dos seus repositórios e rode git pull. Se funcionar sem pedir nada, o GitSquid vai fazer push e pull sem configuração alguma.

Se ele pedir credenciais, a sua autenticação morava dentro do SourceTree e não no helper do Git. Resolva isso uma vez no nível do Git (configure um credential helper para HTTPS, ou uma chave SSH) e todas as ferramentas da sua máquina se beneficiam, GitSquid incluído.

Tokens de hospedagem: Configurações → Integrações

A segunda camada é opcional, mas vale a pena. Em Configurações → Integrações, você pode adicionar um token para GitHub, GitLab ou Bitbucket. Esses tokens alimentam os seletores de repositório (navegue e clone seus repos remotos de dentro do app) e os recursos de pull request — listar, criar e revisar PRs sem sair do GitSquid.

Uma nota específica sobre o Bitbucket, já que a maioria dos usuários de SourceTree usa Bitbucket: as app passwords estão deprecadas. Em vez disso, crie um token de API da Atlassian em id.atlassian.com/manage-profile/security/api-tokens e cole-o na integração do Bitbucket junto com o seu e-mail Atlassian.

Passo 4: mapeie os seus hábitos do SourceTree (5 minutos)

O modelo mental se transfere quase um para um. Aqui está onde cada hábito do SourceTree cai no GitSquid:

Dois desses merecem um olhar mais de perto.

Staging por linha. O SourceTree permite fazer staging de hunks, e isso foi genuinamente à frente do seu tempo. O GitSquid vai um nível mais fundo: arraste para selecionar as linhas exatas que você quer dentro de um hunk e faça staging só delas. Se você já dividiu um hunk no SourceTree para isolar duas mudanças sem relação, isso substitui aquela dança por completo.

O log de comandos. O botão de terminal do SourceTree te joga em um shell para fazer o que a GUI não consegue. O GitSquid ataca a mesma necessidade pela direção oposta: o log de comandos (Cmd/Ctrl+Shift+L) mostra cada comando git que o app executa em seu nome, com os argumentos, e cada linha é copiável. Você vê exatamente o que a GUI está fazendo, pode repetir em qualquer terminal e, de quebra, ele acaba sendo o melhor professor de Git que a maioria das GUIs nunca teve.

Passo 5: o que você ganha que o SourceTree nunca teve

Os passos acima te deixam em pé de igualdade. Estas são as coisas esperando do outro lado que não têm equivalente no SourceTree:

• Conflict Predictor (grátis) — antes de fazer merge, rebase ou cherry-pick, veja quais arquivos vão entrar em conflito. O fim do "merge e reza".
• Linha do tempo de arquivos com controle deslizante (grátis) — arraste um slider pelo histórico de qualquer arquivo e veja-o evoluir commit a commit.
• Detecção de escopo em monorepos (Pro) — o GitSquid detecta seus workspaces e permite limitar a visão a um único pacote, em vez de se afogar no barulho do repo inteiro.
• Mensagens de commit e descrições de PR com IA (Pro) — geradas a partir do seu diff real, usando a sua própria chave de API com o provedor que você escolher.
• Varredura de segredos pré-commit (Pro) — chaves de API e tokens são pegos antes do commit, e não depois do force-push da vergonha.
• Suporte a Linux — o mesmo app, na plataforma que o SourceTree nunca alcançou.
• arm64 nativo nas três plataformas — Apple Silicon, Windows on ARM e Linux ARM rodam builds nativas.

Do que você pode honestamente sentir falta

Duas coisas, para sermos justos:

• O preço. O SourceTree é totalmente gratuito, e esse é o seu argumento mais forte. O GitSquid tem um plano Free que cobre o fluxo de trabalho do dia a dia — staging, commits, branches, merges, o Conflict Predictor, a linha do tempo de arquivos — e um plano Pro a 49 EUR/ano para os recursos avançados acima. Se o seu orçamento é exatamente zero e o desempenho do SourceTree não te incomoda, ficar onde está é uma escolha defensável.
• Mercurial. Se você é um dos poucos que ainda resiste: o próprio SourceTree abandonou o suporte a Mercurial há muito tempo, mas se por algum motivo você ainda precisa de hg, o GitSquid não vai ajudar — ele é só Git, por escolha de design.

Resumindo

Essa é toda a migração: instalar, reabrir as suas pastas, acertar as credenciais uma única vez e reaprender a posição de talvez três botões. Sem exports, sem importadores, sem lock-in em nenhuma direção — os seus repositórios nunca pertenceram a GUI nenhuma, desde o início.

O SourceTree conquistou o seu lugar na história do Git ao tornar o controle de versão visual quando nada mais gratuito fazia isso. Mas tudo bem ser grato a uma ferramenta e, ainda assim, superá-la. Experimente o GitSquid ao lado dele por uma semana; se não pegar, o SourceTree continua ali no seu dock.

Vindo de outro cliente? Temos o mesmo guia para migrar do GitKraken.

Baixe o GitSquid Free e dispare o cronômetro — 15 minutos é uma promessa, não um slogan.