Combinaciones de teclas

Todos los atajos de teclado se pueden personalizar mediante ~/.pi/agent/keybindings.json. Cada acción puede estar vinculada a una o más claves.

El archivo de configuración usa los mismos identificadores de combinación de teclas con espacios de nombres que pi usa internamente y que los autores de extensiones usan en los administradores keyHint() e inyectados keybindings.

Las configuraciones más antiguas que utilizan identificadores con espacios de nombres previos, como cursorUp o expandTools, se migran automáticamente a los identificadores con espacios de nombres al inicio.

Después de editar keybindings.json, ejecute /reload en pi para aplicar los cambios sin reiniciar la sesión.

modifier+key donde los modificadores son ctrl, shift, alt, super (combinables) y las claves son:

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

Combinaciones de modificadores: ctrl+shift+x, alt+ctrl+x, ctrl+shift+alt+x, super+k, ctrl+super+k, ctrl+1, etc.

Los enlaces super requieren un terminal que informe el modificador por separado, generalmente a través del protocolo de teclado Kitty. Es posible que no funcionen en terminales sin ese soporte.

Las acciones de historial dedicadas siempre cambian las entradas del historial, independientemente de la posición del cursor en un mensaje de varias líneas. Los enlaces de historial explícitos tienen prioridad sobre las acciones de la aplicación mientras el editor principal está enfocado, por lo que el enlace tui.editor.historyPrevious a ctrl+p anula el ciclo del modelo en ese contexto sin cambiar Ctrl+P en los selectores.

Estas acciones se aplican cuando el modo interactivo usa --tui-mode fullscreen y apunta a la región de desplazamiento de la transcripción principal. El trackpad con dos dedos y la entrada con la rueda del mouse desplazan la región debajo del puntero, volviendo a la transcripción sobre el editor fijo/estado/pie de página. Al hacer clic en un hipervínculo OSC 8, se abre en el controlador predeterminado. Arrastrar con el botón principal del mouse selecciona el texto y lo copia en el portapapeles; Al mantener presionado el borde superior o inferior de la transcripción, se desplaza automáticamente hacia el contenido fuera de la pantalla.

Los enlaces de transcripción de pantalla completa tienen prioridad sobre los enlaces del editor. Por lo tanto, las teclas de navegación predeterminadas no modificadas controlan la transcripción en modo de pantalla completa, mientras que sus variantes ctrl continúan controlando el editor. Fuera del modo de pantalla completa, ambas variantes controlan el editor.

Este enrutamiento sigue siendo configurable a través de los enlaces de acción ordinarios. Por ejemplo, "tui.altScreen.pageUp": "ctrl+pageUp" hace que pageUp controle el editor y ctrl+pageUp controle la transcripción en modo de pantalla completa. Enlace tui.altScreen.halfPageUp y tui.altScreen.halfPageDown para pasos de transcripción más pequeños manteniendo los enlaces de página completa. La configuración "tui.altScreen.pageUp": [] desactiva por completo ese acceso directo a la transcripción. Los enlaces de usuario reemplazan los valores predeterminados para esa acción.

Se utiliza dentro del selector de modelos con alcance (se abre mediante /scoped-models).

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

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

Cada acción puede tener una única clave o una serie de claves. La configuración del usuario anula los valores predeterminados.

En Windows nativo, app.suspend no tiene enlace predeterminado porque los terminales de Windows no admiten el control de trabajos de Unix. Si lo vincula manualmente, pi muestra un mensaje de estado en lugar de suspenderlo. En WSL, el comportamiento normal de Linux ctrl+z/fg todavía 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"]
}