pi-emacs-which-key

Emacs-style editing and prefix-key discoverability for Pi's interactive editor.

Features

• C-g universal cancel / keyboard-quit for this editor extension.
• C-x, C-c, C-h, and M-x prefix maps.
• Native Pi TUI which-key panel using Container, Text, and DynamicBorder.
• Emacs movement/editing keys such as C-n, C-p, C-a, C-e, M-f, M-b, C-k, C-y, M-y.

Key map

• C-x b → /resume
• C-x k → /new
• C-x t → /tree
• C-x f → /fork
• C-x s → /session
• C-x m → /model
• C-x p → /scoped-models
• C-x o → toggle tool output
• C-x C-e → external editor
• C-x C-c → quit Pi
• C-c h → /handoff
• C-c r → /reload
• C-h b → /hotkeys
• C-h k → describe next key
• C-h m → extension status
• M-x → open Pi slash-command completion

Install

pi install npm:pi-emacs-which-key

Then in Pi:

/reload

Development install

pi install /path/to/pi-emacs-which-key

Or run for one session without installing:

pi -e /path/to/pi-emacs-which-key/extensions/emacs-which-key.ts

Optional selector keybindings

The extension handles C-n / C-p in Pi's editor and slash-command completion. For Pi's other built-in selection dialogs such as /model and /resume, add this to ~/.pi/agent/keybindings.json if you want Emacs navigation there too:

{
  "tui.select.up": ["up", "ctrl+p"],
  "tui.select.down": ["down", "ctrl+n"]
}

Then run /reload.

Notes

This package uses Pi extension APIs and native Pi TUI components. It is intentionally editor-local: it does not overwrite your global keybindings.json.