Configuração Pessoal do Tmux para Aumentar a Produtividade no Terminal

0. Por Que Usar Tmux?

É mais fácil entender se você comparar o terminal a um 'Navegador Web'.

Multitarefa (Abas e Janelas) Assim como você abre múltiplas abas no navegador para pesquisar, assistir YouTube e verificar email simultaneamente, o Tmux permite que você rode um servidor, edite código e verifique logs ao mesmo tempo em uma única janela de terminal.

Persistência de Sessão (Rede de Segurança) Esta é sua característica mais poderosa. Se você está trabalhando em um servidor remoto e a internet desconecta ou você fecha o terminal acidentalmente, a sessão do Tmux continua viva em background. Quando você reconecta (attach), restaura exatamente como você deixou.

Terminologia

• Session

  • Equivalente a toda a janela do navegador.
  • Assim como você pode manter janelas separadas para Projeto A e Projeto B, é o maior container que guarda todo o contexto do seu trabalho.

• Window

  • Equivalente a uma 'Aba' no navegador.
  • Um espaço dentro de uma única sessão onde você alterna telas para propósitos diferentes, como Servidor (1) e BD (2).

• Pane

  • Uma tela dividida cima/baixo ou esquerda/direita dentro de uma única aba.
  • Uma área dividida em uma janela onde você pode ver um editor à esquerda e logs à direita simultaneamente.

1. Instalação e Plugins Essenciais

Baseado em ambiente Mac (Homebrew). Você deve instalar TPM (Tmux Plugin Manager) após a instalação básica para utilizar 100% de seus recursos poderosos.

1. Instalar Tmux

brew install tmux

2. Instalar Gerenciador de Plugins (TPM)

Essencial para gerenciar facilmente vários plugins.

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

2. Configurações de Otimização Prática

(.tmux.conf) Mudei as configurações padrão do Tmux (a tecla prefix C+b é muito longe e desconfortável) para se adequar a um fluxo de trabalho prático.

Crie o arquivo vi ~/.tmux.conf e cole o conteúdo abaixo exatamente.

# ==========================================
# 1. Configurações Básicas de Conveniência
# ==========================================
# Mudar Tecla Prefix (Padrão Ctrl+b torce sua mão -> Mudar para Ctrl+a)
set -g prefix C-a
unbind C-b
bind C-a send-prefix
 
# Habilitar Mouse (Redimensionar painéis, scroll, etc.)
set -g mouse on
 
# Configurações de Índice (Teclado 0 é muito longe, começar do 1)
set -g base-index 1
set -g pane-base-index 1
set -g renumber-windows on   # Renumerar janelas automaticamente quando fechadas
 
# ==========================================
# 2. Atalhos de Teclas
# ==========================================
# Divisão Intuitiva (Dividir mantendo caminho atual)
# | : Dividir Horizontalmente
# - : Dividir Verticalmente
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
 
# Modo de Cópia Estilo Vim (v:selecionar, 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 navegação entre Vim e Tmux (Ctrl+hjkl)
set -g @plugin 'christoomey/vim-tmux-navigator'
 
# Carregar Plugins Essenciais
set -g @plugin 'tmux-plugins/tpm'
set -g @plugin 'tmux-plugins/tmux-sensible'
 
# Executar TPM (Deve estar no final do arquivo)
run '~/.tmux/plugins/tpm/tpm'

• Gerenciador de Plugins (TPM)

  • Funciona como a App Store do seu smartphone. É uma ferramenta central que permite instalar e atualizar instantaneamente plugins necessários com um único atalho (Ctrl + a + I) sem configuração manual complexa.

• Otimização Essencial (Sensible)

  • Resolve o frustrante atraso de input de tecla (Esc) e problemas de velocidade de renderização do estado padrão.

Como Aplicar Configurações:

1. Salve o arquivo acima.
2. Digite tmux source ~/.tmux.conf no terminal.
3. Após iniciar o Tmux, pressione Ctrl + a depois I (I maiúsculo) para instalar plugins.

3. Função de Execução Inteligente

t

Digitar tmux new -s ... toda vez é trabalhoso. Adicione este comando curto ao seu arquivo de configuração do shell (~/.zshrc, etc.) para "criar se não existe, conectar se existe".

Bash

# t [nome] : Conecta se sessão existe, cria se não
function t() {
  if [ -z "$1" ]; then
    # Conecta à sessão 'main' se 't' é digitado sem nome
    tmux new -A -s main
  else
    # Conecta à sessão correspondente se 't nome_projeto' é digitado
    tmux new -A -s "$1"
  fi
}

• Uso: Quer criar uma sessão "Hello"? -> Apenas digite t Hello no terminal.

4. Cheatsheet de Atalhos

Todos os comandos são inseridos após pressionar o Prefix (Ctrl + a).

5. Solução de Problemas: Quando Mover para Direita (Ctrl+l) Não Funciona

Dica Importante para ambientes focados em teclado que não usam mouse.

Mesmo com configurações perfeitas, você pode encontrar um fenômeno onde "Esquerda (Ctrl+h) funciona mas Direita (Ctrl+l) não move".

Causa: Conflito de Terminal

Em sistemas Unix, Ctrl + l é o comando "Limpar Tela". Isso acontece porque o App de Terminal (iTerm2, Alacritty, etc.) intercepta esta tecla antes que o Tmux ou Vim receba o sinal.

Diagnóstico (Teste cat)

Execute o seguinte no terminal para pegar o culpado.

1. Digite cat em qualquer shell e pressione Enter (estado de espera de input).
2. Pressione Ctrl + l.
   • Se ^L aparece na tela? → Normal (Não é problema do terminal).
     • Se ^L aparece ao pressionar Ctrl + l, significa que o shell reconheceu o input como 'literal'.
   • Se a tela limpa? → Culpado Encontrado (Terminal interceptou a tecla).

Solução

Você precisa desvincular o mapeamento Ctrl + l nas configurações do terminal.

• iTerm2: Settings > Profiles > Keys > Key Mappings -> Delete item ^l.

• Alacritty/Zsh: Adicione o código abaixo na configuração do seu shell (~/.zshrc) para desvincular a tecla.

Desvincular Ctrl+l (Ceder ao Vim/Tmux)

bindkey -r "^L"