キーバインドリファレンス

Pi では、app.session.new などの名前付きアクションが公開されており、キーバインドを割り当てられます。Pi のユーザー設定で、デフォルトの割り当てを変更したり、未割り当てのアクションにキーを割り当てたりできます。

/hotkeys を実行すると、メインエディターとアプリケーションで現在有効なショートカットを確認できます。

キーバインドの割り当て#

<agent-dir>/keybindings.json を作成します。エージェントディレクトリのデフォルトは ~/.pi/agent で、エージェントディレクトリで説明されています。

各アクション識別子を、1 つのキーまたはキーのリストにマッピングします。

{
  "app.session.new": "ctrl+shift+n",
  "app.session.tree": ["ctrl+shift+t", "alt+shift+t"]
}

設定した値は、そのアクションのデフォルト値を置き換えます。アクションのキーバインドを無効にするには、空のリストを使用します。

{
  "tui.altScreen.pageUp": []
}

ファイルを編集した後、/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 キーボードプロトコルを介して、修飾キーを個別に報告するターミナルが必要です。そのサポートがないターミナルでは動作しない場合があります。

アクション#

ターミナル UI#

カーソル移動#

専用の履歴アクションは、カーソル位置に関係なくプロンプト履歴を参照し、同じキーを使用するアプリケーションアクションより優先されます。

テキスト編集#

入力と選択#

フルスクリーン#

フルスクリーンモードでは、これらのアクションがトランスクリプトを制御し、同じキーを使用するエディターアクションより優先されます。

アプリケーション#

ネイティブ Windows では、Windows ターミナルが Unix のジョブ制御をサポートしていないため、app.suspend にデフォルトはありません。手動で割り当てた場合、Pi はサスペンドする代わりにステータスメッセージを表示します。WSL では通常どおり ctrl+z と fg を使用できます。

セッション#

モデルと思考#

表示とメッセージキュー#

ツリーナビゲーション#

スコープ付きモデルセレクター#

スコープ対象モデルセレクター（/scoped-models で開きます）内で使用します。