Configuración personal de Tmux para aumentar la productividad en la terminal

0. ¿Por qué usar Tmux?

Es más fácil de entender si comparas la terminal con un 'Navegador Web'.

Multitarea (Pestañas y Ventanas) Al igual que abres varias pestañas en un navegador para buscar, ver YouTube y revisar el correo simultáneamente, Tmux te permite ejecutar un servidor, editar código y revisar registros al mismo tiempo dentro de una sola ventana de terminal.

Persistencia de Sesión (Red de Seguridad) Esta es su función más potente. Si estás trabajando en un servidor remoto y se corta Internet o cierras la terminal accidentalmente, la sesión de Tmux permanece viva en segundo plano. Cuando te vuelves a conectar (attach), se restaura exactamente como la dejaste.

Terminología

• Sesión (Session)

  • Equivalente a toda la ventana del navegador.
  • Al igual que mantienes separadas las ventanas del Proyecto A y el Proyecto B, es el contenedor más grande que guarda todo el contexto de tu trabajo.

• Ventana (Window)

  • Equivalente a una 'Pestaña (Tab)' en un navegador.
  • Un espacio dentro de una sola sesión donde cambias de pantalla para diferentes propósitos, como Servidor (1) y Base de Datos (2).

• Panel (Pane)

  • Una pantalla dividida arriba/abajo o izquierda/derecha dentro de una sola pestaña.
  • Un área dividida en una ventana donde puedes ver un editor a la izquierda y registros a la derecha simultáneamente.

1. Instalación y Plugins Esenciales

Basado en el entorno Mac (Homebrew). Debes instalar TPM (Tmux Plugin Manager) después de la instalación básica para utilizar el 100% de sus potentes funciones.

1. Instalar Tmux

brew install tmux

2. Instalar Gestor de Plugins (TPM)

Esencial para gestionar fácilmente varios plugins.

git clone https://github.com/tmux-plugins/tpm ~/.tmux/plugins/tpm

2. Configuración de Optimización Práctica

(.tmux.conf) Cambié la configuración predeterminada de Tmux (la tecla de prefijo C+b está demasiado lejos y es incómoda) para adaptarla a un flujo de trabajo práctico.

Crea el archivo vi ~/.tmux.conf y pega el contenido a continuación exactamente.

# ==========================================
# 1. Configuración Básica de Conveniencia
# ==========================================
# Cambiar Tecla de Prefijo (Ctrl+b predeterminado tuerce la mano -> Cambiar a Ctrl+a)
set -g prefix C-a
unbind C-b
bind C-a send-prefix
 
# Habilitar Ratón (Redimensionar paneles, desplazamiento, etc.)
set -g mouse on
 
# Configuración de Índice (El 0 del teclado está muy lejos, empezar desde 1)
set -g base-index 1
set -g pane-base-index 1
set -g renumber-windows on   # Renumerar ventanas automáticamente al cerrar
 
# ==========================================
# 2. Atajos de Teclado (Key Bindings)
# ==========================================
# División Intuitiva (Dividir manteniendo la ruta actual)
# | : Dividir Horizontalmente
# - : Dividir Verticalmente
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
 
# Modo de Copia Estilo Vim (v:seleccionar, y:copiar)
set-window-option -g mode-keys vi
bind-key -T copy-mode-vi v send-keys -X begin-selection
bind-key -T copy-mode-vi y send-keys -X copy-selection-and-cancel
 
# ==========================================
# 3. Plugins
# ==========================================
# Integrar navegación entre Vim y Tmux (Ctrl+hjkl)
set -g @plugin 'christoomey/vim-tmux-navigator'
 
# Cargar Plugins Esenciales
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
 
# Ejecutar TPM (Debe estar al final del archivo)
run '~/.tmux/plugins/tpm/tpm'

• Gestor de Plugins (TPM)

  • Actúa como la App Store de tu teléfono inteligente. Es una herramienta fundamental que te permite instalar y actualizar instantáneamente los plugins necesarios con un solo atajo (Ctrl + a + I) sin configuraciones manuales complejas.

• Optimización Esencial (Sensible)

  • Resuelve el frustrante retraso de entrada de teclas (Esc) y los problemas de velocidad de renderizado de pantalla del estado predeterminado.

Cómo Aplicar la Configuración:

1. Guarda el archivo anterior.
2. Escribe tmux source ~/.tmux.conf en la terminal.
3. Después de iniciar Tmux, presiona Ctrl + a y luego I (i mayúscula) para instalar los plugins.

3. Función de Ejecución Inteligente

t

Escribir tmux new -s ... cada vez es engorroso. Añade este comando corto a tu archivo de configuración de shell (~/.zshrc, etc.) para "crear si no existe, conectar si existe".

Bash

# t [nombre] : Conectar si la sesión existe, crear si no
function t() {
  if [ -z "$1" ]; then
    # Conectar a la sesión 'main' si se escribe 't' sin nombre
    tmux new -A -s main
  else
    # Conectar a la sesión correspondiente si se escribe 't nombre_proyecto'
    tmux new -A -s "$1"
  fi
}

• Uso: ¿Quieres crear una sesión "Hola"? -> Simplemente escribe t Hola en la terminal.

4. Hoja de Trucos de Atajos Clave (Cheatsheet)

Todos los comandos se introducen después de presionar el Prefijo (Ctrl + a).

5. Solución de Problemas: Cuando Mover a la Derecha (Ctrl+l) No Funciona

Tip Importante para entornos centrados en el teclado que no usan ratón.

Incluso con una configuración perfecta, podrías encontrar un fenómeno donde "Izquierda (Ctrl+h) funciona pero Derecha (Ctrl+l) no se mueve".

Causa: Conflicto de Terminal

En sistemas Unix, Ctrl + l es el comando "Limpiar Pantalla (Clear)". Esto sucede porque la App de Terminal (iTerm2, Alacritty, etc.) intercepta esta tecla antes de que Tmux o Vim reciban la señal.

Diagnóstico (Prueba cat)

Realiza lo siguiente en la terminal para encontrar al culpable.

1. Escribe cat en cualquier shell y presiona Enter (Estado de espera de entrada).
2. Presiona Ctrl + l.
   • ¿Si aparece ^L en la pantalla? → Normal (No es un problema de la terminal).
     • Si aparece ^L al presionar Ctrl + l, significa que el shell reconoció la entrada de la tecla como un 'literal'.
   • ¿Si la pantalla se borra? → Culpable Encontrado (La terminal interceptó la tecla).

Solución

Necesitas desvincular el mapeo de Ctrl + l en la configuración de la terminal.

• iTerm2: Settings > Profiles > Keys > Key Mappings -> Eliminar el elemento ^l.

• Alacritty/Zsh: Añade el código a continuación a tu configuración de shell (~/.zshrc) para desvincular la tecla.

Desvincular Ctrl+l (Ceder a Vim/Tmux)

bindkey -r "^L"