vim-mode-pi

Vim modal editor for pi's TUI input

Package details

extension

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

$ pi install npm:vim-mode-pi

Pi manifest JSON

{
  "extensions": [
    "./extensions"
  ]
}

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

Vim modal editing for pi's TUI input. Normal + insert modes, motions, operators, counts, undo, kill-ring paste.

pi install git:github.com/Javier-Romario/vim-mode-pi@v0.1.0

Then /reload (or restart pi).

Normal — default for navigation/editing. Esc here aborts the agent (pi default).
Insert — passes through to the default editor. Esc returns to normal.

Key	Action
`h` `j` `k` `l`	move (logical lines, no wrap)
`0` `$` `^`	line start / end / first non-blank
`w` `b` `e`	word forward / backward / word end
`gg` `G`	first / last line
`x` `X`	delete char forward / backward
`dd` `D`	delete line / delete to EOL
`cc` `C` `S`	change line / change to EOL / change line
`d{motion}` `c{motion}`	delete/change over motion (`dw de db d$ d0 d^ dG`)
`i a A I o O`	insert / append / append EOL / insert at `^` / open below / open above
`r{char}`	replace char under cursor
`u`	undo
`p`	paste (yank kill ring)
`[count]`	repeat (`3j`, `5w`, `2dd`, ...)

In normal mode, Enter moves down (vim). Submit via i then Enter.

Depends on pi-bundled packages (@earendil-works/pi-coding-agent, @earendil-works/pi-tui); declared as peerDependencies.
Uses pi editor internals not in the public API. May break across pi releases.