google-terminal-search

Depois de 16 anos operando plataformas em produção, a maior parte do meu dia acontece em um terminal: aws, terraform, kubectl, git, logs. O ciclo mais frequente é ler uma exceção — AccessDeniedException, CrashLoopBackOff, um erro do pnpm — e precisar procurá-la. Cada busca exige o mesmo ritual: copiar o texto, trocar para o navegador, colar, voltar. Parece barato; não é. São 5 a 10 segundos por busca, dezenas de vezes por dia, e o custo real não é o tempo — é a quebra de contexto. Quando volto ao terminal, perdi o fio do que estava depurando.

O que este repositório resolve: encurtar esse ciclo a um comando. Você digita a consulta onde já está, e o navegador abre com o resultado. O texto nunca passa pela área de transferência, então não sobrescreve o que você tinha copiado antes.

O que ele deliberadamente não faz: não raspa a página de resultados do Google. Uma ferramenta que baixa o HTML de busca com curl funciona por uma semana e depois começa a receber CAPTCHA e bloqueio por IP — eu já mantive uma dessas e o custo de manutenção não compensa um utilitário de conveniência. Delegar a renderização ao navegador é a decisão que mantém o script pequeno e sem manutenção.

Um script desse tamanho tem três partes, e cada uma tem um modo de falha próprio.

Coleta dos argumentos: a consulta é "$" ou "$@" juntado com espaço. A diferença importa: sem as aspas, o Bash quebra a consulta em palavras e recola com um espaço só, o que destrói espaços duplos e qualquer glob — um na mensagem de erro vira a lista de arquivos do diretório atual.

Codificação da URL: o Google aceita espaço como + ou %20, mas &, # e % precisam virar %26, %23 e %25 — senão o & corta a query no meio e o # vira fragmento que nem chega ao servidor. Em Bash puro, isso é um loop sobre os bytes com printf '%%%02X', ou um sed com a tabela de escape. Não há biblioteca; há uma dúzia de linhas que você consegue auditar.

Entrega ao navegador: aqui está a única bifurcação por sistema. open "$url" no macOS, xdg-open "$url" no Linux, detectados por uname ou por command -v. No WSL, o caminho útil é wslview ou cmd.exe /c start — se o script não tratar esse caso, a URL abre dentro do Linux, sem navegador, e falha em silêncio.

A lição por trás de manter isso em Bash em vez de Python: o custo de um utilitário assim não é escrevê-lo — é mantê-lo funcionando em toda máquina nova por anos. Bash está em todas elas.

Este repositório é pequeno de propósito e, ainda assim, passa pela mesma régua que os meus repositórios maiores. As regras vêm do platform: branch nomeada como <tipo>/<escopo> (feat/, fix/, chore/, docs/), commit e título de PR em Conventional Commits, e a versão calculada a partir dos commits — ninguém escreve número de versão à mão. O pr-lint, o CI, a varredura de segurança e o release são workflows reutilizáveis chamados daqui; corrigir a régua é mudar um arquivo lá, não em cada repositório.

O motivo de aplicar isso a um utilitário de shell é o mesmo de aplicar a um Lambda: o custo de uma convenção é pago uma vez, e a exceção é paga toda vez que alguém abre o repositório e pergunta "por que este é diferente?". Depois de manter dezenas de repositórios, aprendi que o que quebra não é a regra rigorosa — é a regra com exceção.

O que isso significa para quem contribui: um PR com título fora do padrão falha no lint antes de qualquer revisão humana. Não é burocracia; é o que permite que o changelog e a tag saiam sem que eu toque em nada.