O Caos dos Múltiplos Repositórios no Seu Computador

Todo desenvolvedor em 2024 conhece a bagunça. Sua máquina local vira um cemitério de clones do Git. Projetos do trampo, hustles paralelos, forks experimentais e repositórios de clientes espalhados por aí. Quantas vezes você já rodou find ~ -name "aquele-repo" de madrugada?

Piora com agentes de código baseados em IA. Ferramentas como Claude Code, GitHub Copilot ou assistentes customizados aceleram tudo. Mas criam um problema: isolamento. Rodar vários agentes ao mesmo tempo — um refatorando infra, outro codando endpoints — exige espaços separados. Um diretório compartilhado vira armadilha.

Trocar branches? Um inferno. Stash de mudanças, checkout, conflitos, recuperação de código perdido. Isso trava humanos e IAs.

A Solução com Três Ferramentas: ghq + gwq + fzf

A comunidade open-source já resolveu. Junte três ferramentas e crie um ambiente organizado, escalável e ideal para workflows com IA.

git worktree: Desenvolvimento Paralelo sem Dor

Antes das ferramentas, entenda git worktree. Recurso nativo do Git que permite múltiplos diretórios de trabalho no mesmo repositório. Nada de trocar branches ou stash. Cada worktree tem sua branch própria.

Perfeito para agentes de IA por causa do isolamento:

• Agente no feature A fica no worktree A
• Agente no bug B usa o worktree B
• Zero interferência
• Avanço paralelo e independente

Alinha com IA moderna. Peça pro Claude analisar código em um worktree, rode testes em outro e mantenha o main limpo — tudo junto.

Ferramenta 1: ghq — Acabe com a Bagunça dos Clones

ghq (GitHub Query) organiza repositórios de forma simples e padronizada. Clona tudo em uma estrutura previsível, baseada na URL remota.

Esqueça clones aleatórios. Com ghq, fica assim:

~/ghq/
  github.com/
    dono/
      repo
  gitlab.com/
    time/
      projeto
  bitbucket.org/
    usuario/
      codigo/

Defina a raiz (geralmente ~/ghq). Pronto: padronize e automatize.

Ferramenta 2: gwq — Gerencie Worktrees com Classe

gwq (git Worktree Query) leva a ideia do ghq pros worktrees. Coloca eles do lado dos clones originais, na mesma raiz.

Configuração no ~/.config/gwq/config.toml:

[naming]
template = '{{.Host}}/{{.Owner}}/{{.Repository}}={{.Branch}}'

[worktree]
basedir = '~/ghq'

Worktrees ganham sufixo claro. Exemplo prático:

~/ghq/
  github.com/acme/api                        # repo original
  github.com/acme/api=feature-pagamentos     # worktree pagamentos
  github.com/acme/api=bugfix-autenticacao    # worktree auth
  github.com/acme/frontend                   # outro repo
  github.com/acme/frontend=redesign-ui       # worktree UI

O =nome-da-branch deixa tudo óbvio. Essencial pra multitarefa com humanos ou IAs.

Ferramenta 3: fzf — Busca Fuzzy que Facilita Tudo

fzf (fuzzy finder) une o time. UI terminal rápida que transforma listas em interfaces interativas e buscáveis.

Exemplo: ghq list | fzf. Digite "api" e filtre na hora. Enter e você já tá no cd do repo certo.

Com estrutura padronizada, vira superpoder. Esqueça caminhos exatos. Use palavras-chave parciais.

Atalhos de Navegação no Shell

Junte as ferramentas e crie funções simples pro shell. Navegação vira moleza.

Pular pra qualquer repo (clone ou worktree):

j() {
  cd "$(ghq list --full-path | fzf)"
}

Trocar worktrees no repo atual:

jw() {
  cd "$(git worktree list | awk '{print $1}' | fzf)"
}

Esses snippets eliminam a troca de contexto que matava a produtividade.

Por Que Isso Brilha com Desenvolvimento via IA

O pulo do gato surge orquestrando múltiplos agentes de IA e seu código. Plataformas como NameOcean's Vibe Hosting usam IA pra lançar features rápido. Estrutura de arquivos previsível não é luxo — é necessidade.

Agentes ganham:

• Navegação rápida no código
• Referências seguras a arquivos
• Separação clara de tarefas paralelas
• Scripts automáticos que não quebram

Como Começar

Instalação em 15 minutos:

1. Instale: ghq, gwq e fzf via gerenciador de pacotes
2. Configure ghq: ghq.root = ~/ghq no Git config
3. Configure gwq: Crie ~/.config/gwq/config.toml com template e basedir
4. Adicione funções: Coloque os atalhos no .bashrc ou .zshrc
5. Clone com ghq: Use ghq get no lugar de git clone

Em horas, você não volta atrás. Em semanas, vira base do seu dev.

Visão Geral

Esse stack reflete uma mudança maior na produtividade dev. Em vez de brigar com o filesystem, a gente se adapta. Em vez de evitar paralelismo, abraçamos — pra humanos e IAs.

Fricções que comiam 10-15% do tempo somam. Cada troca evitada é ganho. Cada conflito pulado preserva fluxo. Cada agente rodando solo em worktree multiplica output.

Se developer experience é prioridade — pra você ou time —, domine isso agora.