Shell Productivity: tmux, fzf & direnv

Mantenha longas execuções de go test ativas no tmux, pule para pacotes com fzf e carregue configurações Go por módulo com direnv em monorepos.

Resumo

Monorepos Go passam mais tempo no terminal do que muitas stacks web: raízes de módulos, múltiplas árvores go.mod e comandos de teste com paridade de CI.

tmux, fzf e direnv reduzem o atrito para que você concentre sua atenção nas falhas, não em sessões perdidas ou valores incorretos de GOPRIVATE.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

# direnv: carrega automaticamente o ambiente ao entrar em um módulo
echo 'export GOTOOLCHAIN=auto' >> .envrc
echo 'export GOPRIVATE=github.com/myorg/*' >> .envrc
direnv allow
 
# fzf: busca difusa por um diretório de pacote
fd -t d . internal | fzf --preview 'ls {}'
 
# fzf + ripgrep: pule para um símbolo
rg -l "func HandleHealth" --glob '*.go' | fzf -m | xargs -r ${EDITOR:-vim}
 
# tmux: sessão nomeada para longa execução de testes
tmux new -s gotest
go test ./... -race -count=1 2>&1 | tee test.log
# desanexar: Ctrl-b d ; reanexar: tmux attach -t gotest

Quando usar isso:

• Quedas de SSH matam uma execução de go test ./... de 20 minutos.
• Você alterna entre várias raízes go.mod diariamente.
• Você deseja resultados do ripgrep com pré-visualização interativa antes de abrir um editor.

Exemplo de Trabalho

#!/usr/bin/env bash
# ~/.config/dotfiles/go-monorepo-setup.sh (ilustrativo)
 
# 1) direnv em um módulo de serviço
cd ~/src/myorg/platform/services/api
cat > .envrc <<'EOF'
export GOTOOLCHAIN=auto
export GOPRIVATE=github.com/myorg/*
export PATH="$(go env GOPATH)/bin:$PATH"
layout go
EOF
direnv allow
 
# 2) atalho fzf: abrir arquivo do repositório (requer fzf instalado)
export FZF_DEFAULT_COMMAND='rg --files --hidden --glob "!vendor/**" --glob "!*.git/*"'
open_go_file() {
  local file
  file=$(fzf -m --preview 'bat -n --color=always {} 2>/dev/null || head -100 {}') || return
  ${EDITOR:-vim} $file
}
 
# 3) sessão tmux com janelas para watch + testes
tmux new-session -d -s api -n shell
tmux send-keys -t api:shell "cd ~/src/myorg/platform/services/api && direnv allow ." C-m
tmux new-window -t api -n test
tmux send-keys -t api:test "go test ./... -count=1 -race 2>&1 | tee ~/artifacts/api-test.log" C-m
tmux attach -t api

O que isso demonstra:

• .envrc com GOPRIVATE e layout go para caminhos cientes de módulos.
• fzf alimentado por listas de arquivos do ripgrep com pré-visualização.
• Janelas tmux separando a configuração do ambiente do shell de testes de longa execução.

Mergulho Profundo

Como Funciona

• tmux é um multiplexador de terminal: sessões sobrevivem a desconexões SSH; janelas e painéis dividem logs, testes e editores.
• fzf é um localizador difuso sobre qualquer lista (arquivos, branches git, caminhos de pacotes go test) com comandos de pré-visualização opcionais.
• direnv intercepta o cd do shell e exporta variáveis de .envrc após direnv allow, prevenindo vazamento de GOPRIVATE entre projetos não relacionados.
• Juntos, eles padronizam a navegação em monorepos sem um IDE pesado para cada host remoto.

Papéis das Ferramentas

Snippets direnv para Go

# .envrc
use go                          # se disponível na biblioteca padrão do direnv
export GOTOOLCHAIN=auto
export GOPRIVATE=*.corp.example.com,github.com/myorg/*
export GOLANGCI_LINT_CACHE=$PWD/.cache/golangci-lint
PATH_add "$(go env GOPATH)/bin"

Execute direnv allow uma vez por diretório após editar .envrc.

Notas Go

# fzf: selecionar um pacote e testá-lo
go list ./... | fzf -m | xargs -r go test -count=1

Combine com go list -json para metadados de caminho de módulo em pré-visualizações avançadas.

Armadilhas

• direnv allow esquecido - Alterações em .envrc não fazem nada silenciosamente. Correção: alias da='direnv allow' e hook no prompt do shell para mostrar o status do direnv.
• Scrollback do tmux vs mouse - Copiar/colar difere dos padrões do terminal. Correção: set -g mouse on em ~/.tmux.conf e aprenda o modo de cópia (Ctrl-b [).
• fzf sem respeito a .gitignore - Alimentar find puro inclui ruído do vendor. Correção: rg --files ou fd com regras de ignorar.
• Vazamento de GOPRIVATE - Exportar em .bashrc aplica em toda a organização a projetos pessoais. Correção: direnv por repositório apenas.
• Múltiplas sessões tmux com o mesmo nome - A conexão falha de forma confusa. Correção: tmux list-sessions e nomear por serviço (api, worker).
• Pré-visualização lenta do fzf em arquivos enormes - Pré-visualizar arquivos gerados de vários MB causa lentidão. Correção: pré-visualizar com head ou bat --line-range 1:80.

Alternativas

FAQs

Relacionados

• Linux CLI Basics - comandos básicos do shell
• Go Toolchain on Linux: Install & Version Switching - GOTOOLCHAIN no direnv
• Search, ripgrep & jq for Debugging - pipelines ripgrep para fzf
• Build, Test & Profile from the Shell - longas execuções de testes
• Packages and Modules Basics - GOPRIVATE e módulos

Versões da Stack: Esta página foi escrita para Go 1.26.x (padrão GC Green Tea, modernizadores go fix - verifique o patch na compilação), chi (última - verifique na compilação), gin (última - verifique na compilação), echo (última - verifique na compilação), google.golang.org/grpc (última - verifique na compilação), sigs.k8s.io/controller-runtime (última - verifique na compilação), kubebuilder (última - verifique na compilação), tinygo (última - verifique os alvos de placa na compilação), wazero (última - verifique na compilação) e golangci-lint (última - verifique o conjunto de linters na compilação).