Atalhos de teclado

Todos os atalhos de teclado podem ser personalizados via ~/.pi/agent/keybindings.json. Cada ação pode estar vinculada a uma ou mais chaves.

O arquivo de configuração usa os mesmos ids de atalho de teclado com namespace que pi usa internamente e que os autores de extensão usam nos gerenciadores keyHint() e keybindings injetados.

Configurações mais antigas usando IDs com namespace pré-como cursorUp ou expandTools são migradas automaticamente para os IDs com namespace na inicialização.

Após editar keybindings.json, execute /reload em pi para aplicar as alterações sem reiniciar a sessão.

modifier+key onde os modificadores são ctrl, shift, alt, super (combináveis) e as chaves são:

• Letras: a-z
• Dígitos: 0-9
• Teclas especiais: escape, esc, enter, return, tab, space, backspace, delete, insert, clear, home, end, pageUp, pageDown, up, down, left, right
• Teclas de função: f1-f12
• Símbolos: `, -, =, [, ], \, ;, ', ,, ., /, !, @, #, $, %, ^, &, *, (, ), _, +, |, ~, {, }, :, <, >, ?

Combinações de modificadores: ctrl+shift+x, alt+ctrl+x, ctrl+shift+alt+x, super+k, ctrl+super+k, ctrl+1, etc.

As ligações super requerem um terminal que reporte o modificador separadamente, normalmente por meio do protocolo de teclado Kitty. Eles podem não funcionar em terminais sem esse suporte.

As ações de histórico dedicadas sempre alteram as entradas do histórico, independentemente da posição do cursor em um prompt multilinha. As ligações explícitas do histórico têm precedência sobre as ações do aplicativo enquanto o editor principal está em foco, portanto, a ligação tui.editor.historyPrevious a ctrl+p substitui o ciclo do modelo nesse contexto sem alterar Ctrl+P nos seletores.

Essas ações se aplicam quando o modo interativo usa --tui-mode fullscreen e tem como alvo a região de rolagem da transcrição primária. O trackpad com dois dedos e a roda do mouse rolam a região sob o ponteiro, retornando à transcrição sobre o encaixe fixo de editor/status/rodapé. Clicar em um hiperlink OSC 8 o abre no manipulador padrão. Arrastar com o botão principal do mouse seleciona o texto e o copia para a área de transferência; segurar a borda superior ou inferior da transcrição rola automaticamente para o conteúdo fora da tela.

As vinculações de transcrição em tela cheia têm precedência sobre as vinculações do editor. As teclas de navegação padrão não modificadas, portanto, controlam a transcrição no modo de tela cheia, enquanto suas variantes ctrl continuam a controlar o editor. Fora do modo de tela cheia, ambas as variantes controlam o editor.

Este roteamento permanece configurável através das ligações de ações comuns. Por exemplo, "tui.altScreen.pageUp": "ctrl+pageUp" faz com que pageUp controle o editor e ctrl+pageUp controle a transcrição no modo de tela cheia. Vincule tui.altScreen.halfPageUp e tui.altScreen.halfPageDown para etapas de transcrição menores, mantendo as encadernações de página inteira. A configuração "tui.altScreen.pageUp": [] desativa totalmente esse atalho de transcrição. As ligações de usuário substituem os padrões dessa ação.

Usado dentro do seletor de modelos com escopo (aberto via /scoped-models).

Crie ~/.pi/agent/keybindings.json:

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.deleteWordBackward": ["ctrl+w", "alt+backspace"]
}

Cada ação pode ter uma única chave ou um conjunto de chaves. A configuração do usuário substitui os padrões.

No Windows nativo, app.suspend não possui ligação padrão porque os terminais do Windows não suportam controle de trabalho Unix. Se você vinculá-lo manualmente, pi mostrará uma mensagem de status em vez de suspender. No WSL, o comportamento normal do Linux ctrl+z/fg ainda se aplica.

{
  "tui.editor.historyPrevious": "ctrl+p",
  "tui.editor.historyNext": "ctrl+n",
  "tui.editor.cursorLeft": ["left", "ctrl+b"],
  "tui.editor.cursorRight": ["right", "ctrl+f"],
  "tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
  "tui.editor.cursorWordRight": ["alt+right", "alt+f"],
  "tui.editor.deleteCharForward": ["delete", "ctrl+d"],
  "tui.editor.deleteCharBackward": ["backspace", "ctrl+h"],
  "tui.input.newLine": ["shift+enter", "ctrl+j"]
}

{
  "tui.editor.cursorUp": ["up", "alt+k"],
  "tui.editor.cursorDown": ["down", "alt+j"],
  "tui.editor.cursorLeft": ["left", "alt+h"],
  "tui.editor.cursorRight": ["right", "alt+l"],
  "tui.editor.cursorWordLeft": ["alt+left", "alt+b"],
  "tui.editor.cursorWordRight": ["alt+right", "alt+w"]
}