Ctrl+s para sessões e Ctrl+g para ferramentas no tmux

Minha configuração do tmux tem dois prefixos próprios além de Ctrl+b:

Ctrl+s → sessões
Ctrl+g → ferramentas

Depois de Ctrl+s, f procura uma sessão, l mostra a árvore, k encerra a sessão atual e algumas letras aplicam layouts. Depois de Ctrl+g, g abre o LazyGit, n abre o Neovim, f abre o Yazi e ? mostra a ajuda.

Não são atalhos globais independentes como Ctrl+Shift+Alt+alguma-coisa. São tabelas temporárias de teclas do próprio tmux.

O vocabulário muda por uma tecla

A documentação oficial do tmux explica que cada binding pertence a uma tabela nomeada. A tabela root recebe teclas sem prefixo; prefix recebe as teclas depois do prefixo padrão; outras tabelas podem ser criadas para modos específicos.

A entrada do meu modo de sessões é:

bind -n C-s \
  display-message "SESSIONS" \; \
  switch-client -T session-key-table

Os comandos seguintes pertencem a session-key-table:

bind -T session-key-table f display-popup -E -w 80% -h 80% \
  "tms 2>/dev/null || $HOME/.config/tmux/bin/sessionize"

bind -T session-key-table l choose-tree -Zs
bind -T session-key-table k run-shell "$HOME/.config/tmux/bin/kill-session"

O modo de ferramentas repete a estrutura com tools-key-table. A primeira tecla escolhe o domínio; a segunda escolhe a ação.

Uma tecla pode conservar seu significado original

Ctrl+s e Ctrl+g já podem ter significado para o programa dentro do painel. Por isso, pressionar a mesma combinação duas vezes envia a tecla para a aplicação:

bind -T session-key-table C-s send-keys C-s
bind -T tools-key-table   C-g send-keys C-g

É um escape explícito. Ainda assim, ele muda o hábito: para entregar Ctrl+s ao programa, preciso digitar Ctrl+s Ctrl+s quando o tmux intercepta a primeira ocorrência.

Há outra borda histórica. Em alguns terminais, Ctrl+s participa do controle de fluxo XON/XOFF e pode pausar a saída antes de o tmux recebê-lo. A configuração não documenta uma defesa para todos os ambientes. O atalho só é portátil quando terminal, shell e tmux entregam a sequência como esperado.

Ferramentas ganham janelas reutilizáveis

O modo Ctrl+g chama um script com nome da janela, comando e diretório do painel atual:

tool-window.sh LazyGit lazygit "#{pane_current_path}"
tool-window.sh Nvim    nvim    "#{pane_current_path}"
tool-window.sh Yazi    yazi    "#{pane_current_path}"

O script procura uma janela com aquele nome na sessão. Se encontrar, seleciona; se não, cria no diretório recebido. Assim, repetir Ctrl+g g tende a voltar ao LazyGit já aberto, em vez de criar outra instância.

Essa identidade pelo nome tem uma consequência. Uma sessão só comporta uma janela chamada LazyGit sob esse contrato, mesmo que eu queira ferramentas em dois diretórios diferentes. O agrupamento favorece reuso, não multiplicidade.

O custo é adicionar estado

Duas tabelas reduzem a quantidade de combinações que preciso memorizar, mas a próxima tecla passa a depender da anterior. f pode ser texto no shell, sessionizer depois de Ctrl+s ou Yazi depois de Ctrl+g.

A configuração mostra “SESSIONS” ou “TOOLS” na linha de mensagem por dois segundos ao entrar em cada tabela. Há também um arquivo de ajuda acessível pelo próprio modo de ferramentas. Essas pistas são importantes porque o agrupamento não remove complexidade; ele a organiza em estados temporários.

Não medi erros ou velocidade antes e depois dessa mudança. O que posso afirmar é que a configuração expressa duas categorias estáveis e evita ocupar uma combinação global para cada ação. O desenho faz sentido enquanto as categorias continuarem pequenas e distintas.

Se começarem a surgir submodos, exceções e teclas com três significados, o ganho se perde. Nesse ponto eu preferiria retirar ações pouco usadas ou deixá-las na paleta de comandos do tmux. Uma tabela de teclas é útil como vocabulário curto; vira um idioma particular quando tenta abrigar tudo.