Verificando acesso...

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