main

Pi Keybindings Reference

Custom Extension Shortcuts

Files Extension

Shortcut Action Mnemonic
Ctrl+X Browse files “X” like Emacs C-x prefix
Alt+O Reveal latest file “O” for Open/Reveal
Alt+Q Quick Look latest file “Q” for Quick look
/files Browse files (command) -

Prompt History (cwd-history)

Shortcut Action
Up/Down Navigate prompt history (auto-seeded from sessions)

Emacs-Style Navigation (keybindings.json)

Cursor Movement

  • Ctrl+P / Ctrl+N - Up / Down
  • Ctrl+B / Ctrl+F - Left / Right
  • Alt+B / Alt+F - Word left / right

Editing

  • Ctrl+D - Delete forward
  • Ctrl+H - Delete backward
  • Ctrl+J - New line

Model Selection

  • Ctrl+L - Open model selector (built-in)
  • Alt+M - Cycle to next model (custom)
  • Alt+Shift+M - Cycle to previous model (custom)

Reserved Keys (Built-in Pi)

  • alt+b - cursorWordLeft
  • alt+f - cursorWordRight ⚠️
  • alt+d - deleteWordForward
  • alt+y - yankPop

Application

  • ctrl+c - copy/clear
  • ctrl+d - deleteCharForward/exit (overridden in keybindings.json)
  • ctrl+g - external editor
  • ctrl+l - select model
  • ctrl+o - expand tools
  • ctrl+p - cycle model (overridden to cursorUp in keybindings.json)
  • ctrl+t - toggle thinking
  • ctrl+z - suspend

Message Queue

  • alt+enter - followUp
  • alt+up - dequeue

Available for Custom Extensions

Safe Alt + Letters

alt+h, alt+i, alt+j, alt+k, alt+l, alt+m, alt+n, alt+o, alt+q, alt+s, alt+u, alt+v, alt+w, alt+x, alt+z

Safe Ctrl + Letters

ctrl+i, ctrl+j, ctrl+m, ctrl+q, ctrl+r, ctrl+s, ctrl+x

Function Keys

F1 through F12 (all available)

Ctrl+Alt Combinations

Most ctrl+alt+letter combinations are available

Configuration

  • Global keybindings: ~/.pi/agent/keybindings.json
  • Extension shortcuts: Defined in extension files (e.g., files.ts)

See pi docs for full keybindings documentation.