Productividad en Shell: tmux, fzf y direnv

Mantén vivas las ejecuciones largas de go test en tmux, salta a paquetes con fzf y carga la configuración de Go por módulo con direnv en monorepos.

Resumen

Los monorepos de Go pasan más tiempo en la terminal que muchas pilas web: raíces de módulos, múltiples árboles de go.mod y comandos de prueba de paridad con CI.

tmux, fzf y direnv reducen la fricción para que dediques tu atención a los fallos, no a las sesiones perdidas o a los valores incorrectos de GOPRIVATE.

Receta

Tarjeta de receta de referencia rápida - lista para copiar y pegar.

# direnv: carga automática del entorno al entrar en un módulo
echo 'export GOTOOLCHAIN=auto' >> .envrc
echo 'export GOPRIVATE=github.com/myorg/*' >> .envrc
direnv allow
 
# fzf: búsqueda difusa de un directorio de paquete
fd -t d . internal | fzf --preview 'ls {}'
 
# fzf + ripgrep: saltar a un símbolo
rg -l "func HandleHealth" --glob '*.go' | fzf -m | xargs -r ${EDITOR:-vim}
 
# tmux: sesión nombrada para ejecución larga de pruebas
tmux new -s gotest
go test ./... -race -count=1 2>&1 | tee test.log
# desconectar: Ctrl-b d ; reconectar: tmux attach -t gotest

Cuándo usar esto:

• Las caídas de SSH matan una ejecución de go test ./... de 20 minutos.
• Cambias entre varias raíces de go.mod diariamente.
• Quieres resultados de ripgrep con vista previa interactiva antes de abrir un editor.

Ejemplo de Trabajo

#!/usr/bin/env bash
# ~/.config/dotfiles/go-monorepo-setup.sh (ilustrativo)
 
# 1) direnv en un módulo de servicio
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) Atajo de teclado fzf: abrir archivo del repositorio (requiere 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) Sesión tmux con ventanas para watch + tests
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

Lo que esto demuestra:

• .envrc con GOPRIVATE y layout go para rutas conscientes del módulo.
• fzf alimentado por listas de archivos de ripgrep con vista previa.
• Ventanas de tmux que separan la configuración del entorno de la shell de las pruebas de larga ejecución.

Análisis Profundo

Cómo Funciona

• tmux es un multiplexor de terminal: las sesiones sobreviven a las desconexiones SSH; las ventanas y paneles dividen logs, pruebas y editores.
• fzf es un buscador difuso sobre cualquier lista (archivos, ramas de git, rutas de paquetes de go test) con comandos de vista previa opcionales.
• direnv engancha el cd de la shell y exporta variables desde .envrc después de direnv allow, evitando fugas de GOPRIVATE entre proyectos no relacionados.
• Juntos, estandarizan la navegación en monorepos sin una IDE pesada para cada host remoto.

Roles de las Herramientas

Snippets de direnv para Go

# .envrc
use go                          # si está disponible en la biblioteca estándar de 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"

Ejecuta direnv allow una vez por directorio después de editar .envrc.

Notas de Go

# fzf: seleccionar un paquete y probarlo
go list ./... | fzf -m | xargs -r go test -count=1

Combina con go list -json para metadatos de ruta de módulo en vistas previas avanzadas.

Trampas

• direnv allow olvidado - Los cambios en .envrc no hacen nada silenciosamente. Solución: alias da='direnv allow' y enganchar el prompt de la shell para mostrar el estado de direnv.
• Scrollback de tmux vs mouse - Copiar/pegar difiere de los valores predeterminados de la terminal. Solución: set -g mouse on en ~/.tmux.conf y aprender el modo de copia (Ctrl-b [).
• fzf sin respeto a .gitignore - Alimentar find simple incluye ruido de vendor. Solución: rg --files o fd con reglas de ignorar.
• Fuga de GOPRIVATE - Exportar en .bashrc se aplica a toda la organización a proyectos personales. Solución: direnv solo por repositorio.
• Sesiones de tmux múltiples con el mismo nombre - La conexión falla de forma confusa. Solución: tmux list-sessions y nombrar por servicio (api, worker).
• Vista previa lenta de fzf en archivos enormes - Previsualizar archivos generados de varios MB retrasa. Solución: previsualizar head o bat --line-range 1:80.

Alternativas

Preguntas Frecuentes

Relacionados

• Conceptos Básicos de la CLI de Linux - comandos fundamentales de la shell
• Go Toolchain en Linux: Instalación y Cambio de Versión - GOTOOLCHAIN en direnv
• Búsqueda, ripgrep y jq para Depuración - pipelines de ripgrep en fzf
• Compilar, Probar y Perfilar desde la Shell - ejecuciones largas de pruebas
• Conceptos Básicos de Paquetes y Módulos - GOPRIVATE y módulos

Versiones de Stack: Esta página fue escrita para Go 1.26.x (predeterminado Green Tea GC, modernizadores de go fix - verificar parche en la compilación), chi (última - verificar en la compilación), gin (última - verificar en la compilación), echo (última - verificar en la compilación), google.golang.org/grpc (última - verificar en la compilación), sigs.k8s.io/controller-runtime (última - verificar en la compilación), kubebuilder (última - verificar en la compilación), tinygo (última - verificar objetivos de placa en la compilación), wazero (última - verificar en la compilación) y golangci-lint (última - verificar conjunto de linters en la compilación).