MÓDULO 3.5

🖥️ Display: tmux, iTerm2, split-pane

Quando vale a pena ver tudo ao vivo, atalhos do lead e armadilhas por terminal.

6
Tópicos
40
Minutos
Intermediário
Nível
Reference
Tipo
1

🪟 In-process: tudo no mesmo terminal

In-process: lead lista teammates; Shift+Down circula; Enter abre, Esc fecha. Funciona em qualquer terminal.

📌 Atalhos do in-process

Os 4 que você precisa decorar.

  • •Shift+Down — circula teammates
  • •Enter — foca no teammate
  • •Esc — interrompe turno
  • •Ctrl+T — toggle task list

💡 Mensagem direta

Selecione teammate (Shift+Down) e digite — mensagem vai direto.

2

📊 Tmux: split-pane real

Tmux: cada teammate ganha pane próprio; você vê tudo simultaneamente. Para diagnóstico e demos é imbatível.

📌 Setup

tmux precisa estar instalado.

  • •Instalar via package manager
  • •--teammate-mode tmux
  • •Default 'auto' usa tmux se já estiver dentro
  • •Clique no pane para interagir

💡 Layout

Comece com 2-3 teammates; 5+ em telas pequenas vira sopa.

3

🍎 iTerm2 + it2 CLI

macOS: iTerm2 com it2 CLI + Python API entrega split-pane sem tmux puro. Mais 'nativo' no Mac.

📌 Setup macOS

Combo recomendado.

  • •Instale it2 CLI
  • •Settings → General → Magic → Enable Python API
  • •Use tmux -CC dentro do iTerm2
  • •Auto-detecta no modo 'auto'
4

🪦 Pitfalls em VS Code/Windows

VS Code integrated terminal, Windows Terminal e Ghostty NÃO suportam split-pane. Use in-process ou outro terminal.

⚠️ Sintoma típico

Você liga split-pane mas só vê o lead. Teammates 'sumiram'. Nenhum erro óbvio.

✓ Funciona com split

  • ✓macOS Terminal + tmux
  • ✓iTerm2 + it2
  • ✓Linux com tmux
  • ✓kitty + tmux

✗ Não funciona

  • ✗VS Code integrated
  • ✗Windows Terminal
  • ✗Ghostty
  • ✗Hyper
5

⌨️ Atalhos do lead

Sem atalhos você perde 50% da produtividade. Com atalhos você opera o time como um pianista. Decore os 4 principais.

📊 Atalhos por modo

  • In-process: Shift+Down, Enter, Esc, Ctrl+T
  • Tmux: Ctrl+B + arrows entre panes
  • iTerm2: Cmd+arrows entre panes
  • Universal: digitar para mensagem
6

🧹 Tmux órfão e cleanup

Quando o team não fecha limpo, sessões tmux ficam órfãs. tmux ls + tmux kill-session -t <name>.

📌 Ordem certa de cleanup

Salve, limpe, feche.

  • •Save first (deliverables)
  • •Cleanup via lead (não via tmux)
  • •Verificar tmux ls
  • •Kill se sobrou órfão

⚠️ Não force kill como hábito

Force kill antes de cleanup leva a configs órfãs e estado inconsistente. Reserve para emergências.

📌 Resumo do Módulo

✓
In-process: tudo no mesmo terminal — Default conservador
✓
Tmux: split-pane real — Cada teammate em um pane
✓
iTerm2 + it2 CLI — Alternativa no macOS
✓
Pitfalls em VS Code/Windows — Onde split NÃO roda
✓
Atalhos do lead — Shift+Down, Ctrl+T, Esc
✓
Tmux órfão e cleanup — Mate sessões esquecidas

Próximo módulo:

4.1 — 6 armadilhas e correções