キーバインド

すべてのキーボード ショートカットは ~/.pi/agent/keybindings.json でカスタマイズできます。各アクションは 1 つ以上のキーにバインドできます。

設定ファイルは、pi が内部で使用するものと、拡張機能の作成者が keyHint() および挿入された keybindings マネージャーで使用するのと同じ名前空間キーバインド ID を使用します。

cursorUp や expandTools などの事前に名前空間が設定された ID を使用する古い構成は、起動時に自動的に名前空間が設定された ID に移行されます。

keybindings.json を編集した後、pi で /reload を実行して、セッションを再起動せずに変更を適用します。

modifier+key ここで、修飾子は ctrl、shift、alt、super (組み合わせ可能)、キーは次のとおりです。

• 文字: a-z
• 数字: 0-9
• 特殊キー: escape, esc, enter, return, tab, space, backspace, delete, insert, clear, home, end, pageUp, pageDown, up, down, left, right
• ファンクションキー: f1-f12
• 記号: `, -, =, [, ], \, ;, ', ,, ., /, !, @, #, $, %, ^, &, *, (, ), _, +, |, ~, {, }, :, <, >, ?

修飾子の組み合わせ: ctrl+shift+x、alt+ctrl+x、ctrl+shift+alt+x、super+k、ctrl+super+k、ctrl+1 など。

super バインディングには、通常は Kitty キーボード プロトコルを通じて、修飾子を個別に報告する端末が必要です。そのサポートのない端末では動作しない可能性があります。

専用の履歴アクションは、複数行プロンプト内のカーソル位置に関係なく、常に履歴エントリを変更します。明示的な履歴バインディングは、メイン エディターがフォーカスされている間はアプリケーションのアクションよりも優先されるため、tui.editor.historyPrevious を ctrl+p にバインドすると、セレクターの Ctrl+P を変更せずに、そのコンテキストでのモデルの循環がオーバーライドされます。

これらのアクションは、インタラクティブ モードで --tui-mode fullscreen を使用し、プライマリ トランスクリプト スクロール領域をターゲットとする場合に適用されます。 2 本指のトラックパッドとマウス ホイール入力により、ポインターの下の領域がスクロールされ、固定エディター/ステータス/フッター ドック上のトランスクリプトに戻ります。 OSC 8 ハイパーリンクをクリックすると、デフォルトのハンドラーで開きます。マウスの主ボタンでドラッグするとテキストが選択され、クリップボードにコピーされます。トランスクリプトの上端または下端を押し続けると、画面外のコンテンツが自動スクロールされます。

フルスクリーンのトランスクリプト バインディングは、エディター バインディングよりも優先されます。したがって、変更されていないデフォルトのナビゲーション キーは全画面モードでトランスクリプトを制御しますが、その ctrl バリアントは引き続きエディターを制御します。フルスクリーン モード以外では、両方のバリアントがエディタを制御します。

このルーティングは、通常のアクション バインディングを通じて引き続き構成可能です。たとえば、"tui.altScreen.pageUp": "ctrl+pageUp" を指定すると、全画面モードで pageUp がエディタを制御し、ctrl+pageUp がトランスクリプトを制御します。ページ全体のバインドを維持しながら、トランスクリプトのステップを小さくするには、tui.altScreen.halfPageUp と tui.altScreen.halfPageDown をバインドします。 "tui.altScreen.pageUp": [] を設定すると、トランスクリプトのショートカットが完全に無効になります。ユーザー バインディングは、そのアクションのデフォルトを置き換えます。

スコープ付きモデル セレクター内で使用されます (/scoped-models 経由で開きます)。

~/.pi/agent/keybindings.json を作成します:

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

各アクションには、単一のキーまたはキーの配列を含めることができます。ユーザー設定はデフォルトをオーバーライドします。

Windows 端末は Unix ジョブ制御をサポートしていないため、ネイティブ Windows では、app.suspend にはデフォルトのバインドがありません。手動でバインドすると、pi は一時停止する代わりにステータス メッセージを表示します。 WSL では、通常の Linux ctrl+z/fg の動作が引き続き適用されます。

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