Como migrar do GitKraken para o GitSquid: um guia passo a passo
Trocar de cliente Git é chato. Você tem uma configuração que funciona — perfis, integrações, temas, atalhos de teclado — e não quer começar do zero. Este guia mostra como replicar sua configuração do GitKraken no GitSquid em cerca de 15 minutos, mais uma tabela de equivalências para as operações Git que você mais usava.
Transparência: este artigo é publicado no site do GitSquid.
Antes de começar
Nada aqui mexe nos seus repositórios. Tanto o GitKraken quanto o GitSquid são apenas leitura sobre suas pastas `.git` — eles chamam comandos Git, não são donos dos dados. Você pode ter ambos instalados em paralelo, apontá-los para o mesmo repositório e voltar atrás a qualquer momento.
Se quiser uma comparação limpa, instale o GitSquid e use-o por uma semana antes de desinstalar o GitKraken. Isso é suficiente para confirmar que o workflow se sustenta.
Passo 1: instalar o GitSquid (2 minutos)
Vá até a página de download e pegue a build para sua plataforma:
- macOS — arm64 nativo (funciona em Intel via Rosetta).
- Windows — x64 nativo ou ARM64 (Snapdragon X / Surface Pro X).
- Linux — AppImage para x64 ou ARM64.
Sem criação de conta. Sem diálogo de consentimento de telemetria. Abra o app e você cai na tela de boas-vindas.
Passo 2: apontar para seus repositórios existentes (2 minutos)
Na tela de boas-vindas clique em "Abrir repositório" e escolha as mesmas pastas que tem no GitKraken. Cada repo abre em sua própria aba, como no GitKraken. A versão Free suporta 3 abas simultâneas; o Pro eleva esse limite para ilimitado.
Repositórios usados recentemente aparecem automaticamente na tela de boas-vindas — você pode pesquisar quando tiver mais de 5.
Passo 3: recriar seus perfis (3 minutos)
Se você usava múltiplas identidades Git no GitKraken (e-mail do trabalho, e-mail pessoal, identidade open-source), recrie-as em Configurações → Perfis:
- Clique em "Criar perfil".
- Insira o nome (ex.: "Trabalho" ou "Open source").
- Defina o nome e e-mail Git exatamente como no GitKraken.
- Se você assina commits, cole o ID da chave GPG no campo de assinatura GPG.
- Repita para cada identidade.
A versão Free suporta 1 perfil; o Pro suporta ilimitados. Trocar de perfil no GitSquid é um único clique na barra de título, mesmo modelo do GitKraken.
Passo 4: conectar seus provedores de hospedagem Git (3 minutos)
Em Configurações → Integrações, conecte cada provedor de hospedagem:
GitHub
- Clique em "Conectar" ao lado do GitHub.
- Abra github.com/settings/tokens e crie um personal access token fine-grained. Conceda os scopes repo e pull request.
- Cole-o no GitSquid. A integração valida chamando `/user`.
GitLab
- Clique em "Conectar" ao lado do GitLab.
- Abra gitlab.com/-/profile/personal_access_tokens e crie um personal access token com scope `api`.
- Cole-o no GitSquid.
Bitbucket Cloud
- Clique em "Conectar" ao lado do Bitbucket.
- O Bitbucket não usa mais app passwords. Crie um Atlassian API token em id.atlassian.com/manage-profile/security/api-tokens.
- Insira seu e-mail Atlassian e o token API. O GitSquid usa e-mail + token para auth HTTP basic, que é o formato que o Bitbucket Cloud espera.
Uma vez conectado, você pode listar / criar / revisar pull requests, gerenciar issues e ver os status de CI para cada provedor diretamente dentro do GitSquid — mesmo workflow do GitKraken.
A versão Free suporta 1 integração; o Pro suporta ilimitadas.
Passo 5: recriar seu tema (1 minuto)
O GitSquid vem com 6 temas por padrão: Dark, Light, Midnight, Solarized Dark, Dracula, Nord. Escolha um em Configurações → Aparência.
Se você usava um tema personalizado do GitKraken, o GitSquid Pro permite criar o seu em Configurações → Temas: edite cada cor (background primary / secondary, accent, text, border) e salve. Não há importação automática a partir do formato GitKraken.
Passo 6: mapear seus atalhos de teclado (2 minutos)
Os atalhos padrão do GitSquid são similares mas não idênticos aos do GitKraken:
| Ação | Padrão GitKraken | Padrão GitSquid |
|---|---|---|
| Buscar commits | Cmd/Ctrl+P | Cmd/Ctrl+F |
| Novo branch | Cmd/Ctrl+B | Cmd/Ctrl+N |
| Commit (em staging) | Cmd/Ctrl+Enter | Cmd/Ctrl+Enter |
| Alternar terminal | n/d | Cmd/Ctrl+` |
| Alternar log de comandos | n/d | Cmd/Ctrl+Shift+L |
| Atalhos de teclado | ? | F1 |
Se quiser remapear qualquer atalho para combinar com sua memória muscular do GitKraken, vá em Configurações → Atalhos (Pro). Clique em qualquer ação, pressione a nova combinação, salve. Restaure atalhos individualmente ou todos com um clique.
Mapeamento de funcionalidades
| Funcionalidade GitKraken | Equivalente GitSquid |
|---|---|
| Grafo de commits | Igual, renderizado em canvas com virtual scrolling |
| Staging (arquivo / hunk / linha) | Igual, mais drag-and-drop e operações sobre pastas |
| Visualizador de diff (unified / split / blame) | Igual, alimentado por CodeMirror com syntax highlighting completo |
| Editor de conflitos de merge | Mesmo editor 3-way com editor de código embutido |
| Rebase interativo | Igual, reordenação por drag-and-drop com ações por commit |
| Cherry-pick / revert / reset | Igual, cherry-pick multi-commit incluído |
| Gerenciamento de stashes | Igual, list / save / apply / pop / drop / clear all |
| Gerenciamento de tags | Igual, criar / deletar / push para o remote |
| Worktrees | Igual, criar / travar / destravar / remover / abrir em aba |
| Submodules | Igual, list / init / update |
| Gitflow | Igual, init + feature / release / hotfix start & finish |
| Git LFS | Igual, track patterns / pull / push / painel de status |
| Visualizador de reflog | Igual com checkout-from-reflog |
| Assinatura GPG | Igual, configurada por perfil |
| Pull requests / issues | Mesmo fluxo para GitHub / GitLab / Bitbucket |
| Mensagens de commit por IA | Sim (Claude Code, Anthropic, OpenAI, custom) |
| AI explain | Novo — clique-direito em commit / hunk / arquivo para explicação em streaming |
| Descrição de PR por IA | Novo — "Generate with AI" no diálogo de criação de PR |
| Preditor de conflitos | Novo — preview dos conflitos antes de merge / rebase / cherry-pick |
| Scan de segredos pré-commit | Novo — bloqueia chaves AWS / GitHub / OpenAI, JWTs etc. |
| Branch intent | Novo — plano markdown anexado ao branch via git notes |
| Escopo monorepo | Novo — auto-detecção de workspaces npm / pnpm / Cargo / Nx |
| Scrubber de timeline de arquivo | Novo — arraste um slider sobre o histórico de qualquer arquivo |
| Timeline de atividade do time | Novo — heatmap por autor × por semana |
| Integração Jira | Não está no GitSquid |
| Integração Azure DevOps | Não está no GitSquid |
| GitLens (VS Code) | Não se aplica — GitSquid é apenas um cliente desktop |
| Perfis na nuvem / sync de configurações | Não está no GitSquid — tudo fica local |
O que vai sentir falta
Para alinhar expectativas, as funcionalidades do GitKraken sem equivalente no GitSquid:
- Integrações Jira / Azure DevOps. Se seu time depende delas, o GitSquid não vai substituir o GitKraken nessa frente. Acompanhamos isso no backlog público.
- Configurações sincronizadas na nuvem. O GitKraken sincroniza perfis e configurações entre máquinas via sua conta Atlassian. O GitSquid mantém tudo local. Se você trabalha em várias máquinas, atualmente precisa refazer os passos 3-6 em cada uma.
- Dashboard de gerenciamento de time. O GitKraken tem funcionalidades admin no nível da organização. O GitSquid é licenciado por assento individual.
Se algo disso é crítico para seu workflow, o GitSquid não será um alvo de migração limpo.
O que vai ganhar
- Metade do preço. 49 EUR/ano vs 96 $/ano.
- Sem conta. Sem tela de login na inicialização.
- Sem telemetria. Nada sai da sua máquina.
- Suporte Linux. Binários nativos para Linux x64 e ARM64 se você trocar de máquina.
- Cold start mais rápido e menos RAM. Tauri / Rust vs Electron.
- Funcionalidades modernas. Preditor de conflitos, scan de segredos, escopo monorepo, file timeline, atividade do time, AI explain — nada disso existe no GitKraken.
- Cadência de release ativa. Atualizações a cada 1-2 semanas com changelogs públicos.
Se decidir voltar atrás
Os dois apps são apenas leitura sobre pastas `.git` — voltar atrás é só relançar o GitKraken. Sem lock-in de dados. Os 49 EUR/ano são anuais, então você pode parar de pagar a qualquer ciclo de renovação.
A migração acima leva cerca de 15 minutos na primeira vez. Faça em uma sexta à tarde e use o GitSquid pela semana seguinte. No final da semana, você vai saber se a economia + as funcionalidades modernas justificam os trade-offs para seu workflow específico.
Baixe o GitSquid Free para começar.