Multiplexores: tmux vs zellij

Un multiplexor divide una terminal en paneles y ventanas, y mantiene tus sesiones vivas aunque cierres el terminal o se caiga la conexión. Combinado con Neovim, te da un espacio de trabajo persistente: editor, servidor, logs y tests, todo a la vez.

¿Por qué un multiplexor?

tmux vs zellij

Navegación transparente (la pieza clave)

El problema: dentro de tmux/zellij, Ctrl-h/j/k/l debería moverte entre paneles; dentro de Neovim, entre splits. Sin integración, chocan. La solución hace que las mismas teclas funcionen sin pensar: si hay un split de Neovim en esa dirección, salta a él; si no, al panel del multiplexor.

Con tmux: vim-tmux-navigator

return {
  "christoomey/vim-tmux-navigator",
  cmd = {
    "TmuxNavigateLeft", "TmuxNavigateDown",
    "TmuxNavigateUp", "TmuxNavigateRight",
    "TmuxNavigatePrevious", "TmuxNavigatorProcessList",
  },
  keys = {
    { "<C-h>", "<cmd>TmuxNavigateLeft<cr>",  desc = "Nav izquierda" },
    { "<C-j>", "<cmd>TmuxNavigateDown<cr>",  desc = "Nav abajo" },
    { "<C-k>", "<cmd>TmuxNavigateUp<cr>",    desc = "Nav arriba" },
    { "<C-l>", "<cmd>TmuxNavigateRight<cr>", desc = "Nav derecha" },
  },
}

vim.pack.add({ { src = "https://github.com/christoomey/vim-tmux-navigator" } })

Con vim.pack no hay bloque keys donde declarar los atajos, pero es que tampoco hacen falta: el plugin crea él solo <C-h>, <C-j>, <C-k>, <C-l> y <C-\> al cargarse. Si prefieres otras teclas, pon vim.g.tmux_navigator_no_mappings = 1 antes del vim.pack.add y defínelas tú con los comandos TmuxNavigate*.

Y en tu ~/.tmux.conf, el lado de tmux (o simplemente set -g @plugin 'christoomey/vim-tmux-navigator' si usas TPM, que instala estas mismas reglas):

# Navegación consciente de Vim (christoomey/vim-tmux-navigator)
vim_pattern='(\S+/)?g?\.?(view|l?n?vim?x?|fzf)(diff)?(-wrapped)?'
is_vim="ps -o state= -o comm= -t '#{pane_tty}' \
    | grep -iqE '^[^TXZ ]+ +${vim_pattern}$'"
bind-key -n 'C-h' if-shell "$is_vim" 'send-keys C-h' 'select-pane -L'
bind-key -n 'C-j' if-shell "$is_vim" 'send-keys C-j' 'select-pane -D'
bind-key -n 'C-k' if-shell "$is_vim" 'send-keys C-k' 'select-pane -U'
bind-key -n 'C-l' if-shell "$is_vim" 'send-keys C-l' 'select-pane -R'

bind-key -T copy-mode-vi 'C-h' select-pane -L
bind-key -T copy-mode-vi 'C-j' select-pane -D
bind-key -T copy-mode-vi 'C-k' select-pane -U
bind-key -T copy-mode-vi 'C-l' select-pane -R

# Calidad de vida
set -g mouse on
set -g base-index 1
set -g renumber-windows on
setw -g mode-keys vi

Con zellij: zellij-nav + autolock

zellij intercepta las teclas con sus modos. La solución combina dos piezas: zellij-nav.nvim (el lado de Neovim) y zellij-autolock (un plugin de zellij que lo pone en modo Locked cuando el panel activo es Neovim, para que no robe las teclas).

return {
  "swaits/zellij-nav.nvim",
  lazy = true,
  keys = {
    { "<C-h>", "<cmd>ZellijNavigateLeftTab<cr>", desc = "Nav izquierda" },
    { "<C-j>", "<cmd>ZellijNavigateDown<cr>", desc = "Nav abajo" },
    { "<C-k>", "<cmd>ZellijNavigateUp<cr>", desc = "Nav arriba" },
    { "<C-l>", "<cmd>ZellijNavigateRightTab<cr>", desc = "Nav derecha" },
  },
  opts = {},
}

vim.pack.add({ { src = "https://github.com/swaits/zellij-nav.nvim" } })

require("zellij-nav").setup()

local map = vim.keymap.set
map("n", "<C-h>", "<cmd>ZellijNavigateLeftTab<cr>",  { desc = "Nav izquierda" })
map("n", "<C-j>", "<cmd>ZellijNavigateDown<cr>",     { desc = "Nav abajo" })
map("n", "<C-k>", "<cmd>ZellijNavigateUp<cr>",       { desc = "Nav arriba" })
map("n", "<C-l>", "<cmd>ZellijNavigateRightTab<cr>", { desc = "Nav derecha" })

vim.api.nvim_create_autocmd("VimLeave", {
  pattern = "*",
  command = "silent !zellij action switch-mode normal",
})

Sessionizers: saltar entre proyectos

El flujo estrella de los pros: un atajo que abre un selector difuso de proyectos y te crea/abre una sesión para el que elijas.

En tmux, el clásico tmux-sessionizer (script de ThePrimeagen) con fzf:

#!/usr/bin/env bash
selected=$(find ~/dev ~/work -mindepth 1 -maxdepth 1 -type d | fzf)
[ -z "$selected" ] && exit 0
name=$(basename "$selected" | tr . _)
tmux new-session -ds "$name" -c "$selected" 2>/dev/null
tmux switch-client -t "$name" 2>/dev/null || tmux attach -t "$name"

En zellij, las sesiones son nativas: zellij attach --create nombre desde el terminal, y dentro de zellij el modo Session (Ctrl-o) más w abre el gestor de sesiones integrado.