pi-modal

Kakoune/Helix-like modal editor for pi prompt input - motion-first with selection markers

Packages

Package details

extension

Install pi-modal from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-modal
Package
pi-modal
Version
0.2.0
Published
May 7, 2026
Downloads
62/mo · 8/wk
Author
unitdhda
License
MIT
Types
extension
Size
98.5 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./dist/index.js"
  ],
  "video": "https://github.com/unitdhda/pi-modal/raw/refs/heads/main/public/showcase.mp4"
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

pi-modal-editor

Helix-aligned modal editor for pi's prompt input. Six modes, motion-first editing, Kakoune-inspired registers.

Install

pi install npm:pi-modal-editor

Modes

Mode Indicator Enter via
Normal -- Esc
Insert [i] i / a
Selection [v] v
Surround [s] m
Register ["] "
History [h] Ctrl+k

Keybindings

Normal

Keys Action
i/a Insert before/after
I/A Insert at start/end
v Selection mode
h/l Left/right
w/b/e Word motions
0/$ Line start/end
d/D Delete char/to end
y/Y Yank char/line
p/P Paste after/before
m Surround mode
" Register mode
Ctrl+k/j History prev/next
u/U Undo/redo

Selection (v)

Keys Action
h/l/w/b Expand
d/y Delete/yank
m Surround
Esc Normal

Surround (m)

Wrap selection with `( ) [ ] { } " ' ``

Register (")

Press a–z to select a named register, then y/p to yank/paste.

History (Ctrl+k)

k/j or ↑/↓ to navigate, Enter to load, Esc to cancel.

Commands

pi /modal-editor:mode
pi /modal-editor:content
pi /modal-editor:help

License

MIT