Raccourcis clavier

Tous les raccourcis clavier peuvent être personnalisés via ~/.pi/agent/keybindings.json. Chaque action peut être liée à une ou plusieurs touches.

Le fichier de configuration utilise les mêmes identifiants de liaison de touches avec espace de noms que pi utilise en interne et que les auteurs d'extensions utilisent dans les gestionnaires keyHint() et keybindings injectés.

Les configurations plus anciennes utilisant des identifiants pré-espaces de noms tels que cursorUp ou expandTools sont automatiquement migrées vers les identifiants avec espace de noms au démarrage.

Après avoir modifié keybindings.json, exécutez /reload dans pi pour appliquer les modifications sans redémarrer la session.

modifier+key où les modificateurs sont ctrl, shift, alt, super (combinables) et les clés sont:

• Lettres: a-z
• Chiffres: 0-9
• Touches spéciales: escape, esc, enter, return, tab, space, backspace, delete, insert, clear, home, end, pageUp, pageDown, up, down, left, right
• Touches de fonction: f1-f12
• Symboles: `, -, =, [, ], \, ;, ', ,, ., /, !, @, #, $, %, ^, &, *, (, ), _, +, |, ~, {, }, :, <, >, ?

Combinaisons de modificateurs: ctrl+shift+x, alt+ctrl+x, ctrl+shift+alt+x, super+k, ctrl+super+k, ctrl+1, etc.

Les liaisons super nécessitent un terminal qui signale le modificateur séparément, généralement via le protocole du clavier Kitty. Ils pourraient ne pas fonctionner dans les terminaux sans ce support.

Les actions d'historique dédiées modifient toujours les entrées de l'historique, quelle que soit la position du curseur dans une invite multiligne. Les liaisons d'historique explicites ont priorité sur les actions de l'application lorsque l'éditeur principal est ciblé, donc la liaison de tui.editor.historyPrevious à ctrl+p remplace le cycle de modèle dans ce contexte sans modifier Ctrl+P dans les sélecteurs.

Ces actions s'appliquent lorsque le mode interactif utilise --tui-mode fullscreen et cible la région de défilement de transcription principale. Le trackpad à deux doigts et la molette de la souris font défiler la région sous le pointeur, en revenant à la transcription sur le dock fixe éditeur/statut/pied de page. Cliquer sur un lien hypertexte OSC 8 l'ouvre dans le gestionnaire par défaut. Faire glisser avec le bouton principal de la souris sélectionne le texte et le copie dans le presse-papiers; en maintenant le bord supérieur ou inférieur de la transcription, vous faites défiler automatiquement le contenu hors écran.

Les liaisons de transcription plein écran ont priorité sur les liaisons de l'éditeur. Les touches de navigation par défaut non modifiées contrôlent donc la transcription en mode plein écran, tandis que leurs variantes ctrl continuent de contrôler l'éditeur. En dehors du mode plein écran, les deux variantes contrôlent l'éditeur.

Ce routage reste configurable via les liaisons d'actions ordinaires. Par exemple, "tui.altScreen.pageUp": "ctrl+pageUp" permet à pageUp de contrôler l'éditeur et à ctrl+pageUp de contrôler la transcription en mode plein écran. Liez tui.altScreen.halfPageUp et tui.altScreen.halfPageDown pour des étapes de transcription plus petites tout en conservant les liaisons pleine page. Le paramètre "tui.altScreen.pageUp": [] désactive entièrement ce raccourci de transcription. Les liaisons utilisateur remplacent les valeurs par défaut pour cette action.

Utilisé dans le sélecteur de modèles étendus (ouvert via /scoped-models).

Créez ~/.pi/agent/keybindings.json:

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

Chaque action peut avoir une seule clé ou un tableau de clés. La configuration utilisateur remplace les valeurs par défaut.

Sous Windows natif, app.suspend n'a pas de liaison par défaut car les terminaux Windows ne prennent pas en charge le contrôle des tâches Unix. Si vous le liez manuellement, pi affiche un message d'état au lieu de le suspendre. Dans WSL, le comportement normal de Linux ctrl+z/fg s'applique toujours.

{
  "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"]
}