terminal-setup

Terminal Setup

Ajuda o usuario a configurar o terminal para funcionar corretamente com o pi.

Pi usa o Kitty keyboard protocol. Terminais que nao suportam esse protocolo tem limitacoes com Shift+Enter, Alt+Enter e outros atalhos.

Diagnostico

Se Shift+Enter nao insere nova linha, pergunte ao usuario qual terminal usa e aplique a config correspondente.

Se o pi parece usar o shell errado (ex: WSL em vez de Git Bash), veja a secao "Windows -- Shell Path".

Configuracoes por Terminal

Windows Terminal

O usuario precisa adicionar ao settings.json (Ctrl+Shift+,):

{
  "actions": [
    {
      "command": { "action": "sendInput", "input": "\u001b[13;2u" },
      "keys": "shift+enter"
    },
    {
      "command": { "action": "sendInput", "input": "\u001b[13;3u" },
      "keys": "alt+enter"
    }
  ]
}

Diga ao usuario para fechar e reabrir completamente o Windows Terminal apos salvar.

Ghostty

Adicionar ao config (~/.config/ghostty/config no Linux, ~/Library/Application Support/com.mitchellh.ghostty/config no macOS):

keybind = alt+backspace=text:\x1b\x7f

Se o usuario tem keybind = shift+enter=text:\n (legado do Claude Code), oriente a remover -- causa conflito com Ctrl+J no pi.

WezTerm

Criar ~/.wezterm.lua:

local wezterm = require 'wezterm'
local config = wezterm.config_builder()
config.enable_kitty_keyboard = true
return config

VS Code Terminal

Adicionar ao keybindings.json:

{
  "key": "shift+enter",
  "command": "workbench.action.terminal.sendSequence",
  "args": { "text": "\u001b[13;2u" },
  "when": "terminalFocus"
}

Paths do keybindings.json:

• macOS: ~/Library/Application Support/Code/User/keybindings.json
• Linux: ~/.config/Code/User/keybindings.json
• Windows: %APPDATA%\Code\User\keybindings.json

Terminais com suporte nativo

Kitty e iTerm2 funcionam sem configuracao adicional.

Terminais nao recomendados