@0xkahi/pi-vim-keys

This Skill addresses the lack of Vim keybindings in the Pi platform (an AI Agent development environment). In practice, developers accustomed to Vim mode often find their workflow inefficient when using the default input box, which only supports standard text editing, forcing frequent mouse and keyboard switching that disrupts focus. After installation, Pi's editor is completely replaced with a Vim-style editor supporting Insert, Normal, Visual, and Visual Line modes, enabling full keyboard operation when writing code, prompts, or documentation.

Usage is straightforward: simply run an installation command to add the Skill globally or locally to Pi. Vim keybindings will then be automatically enabled in Pi's editor. By default, press Esc to enter Normal mode, but you can configure sequences like jj or kj. By setting a leader key binding, you can map common operations (such as opening an external editor, pasting images, restoring sessions, etc.) to shortcuts, even supporting multi-character sequences like <leader>oe. In Visual mode, it also supports surround operations to quickly add brackets or quotes to selected text.

It is ideal for developers who already use Vim or Neovim in their daily workflow, especially those using Pi as an AI Agent coding assistant and frequently editing code and prompts. For team collaboration, a local installation (using the -l parameter) writes the configuration to the project directory, making it easy for team members to share the same Vim keybindings and shortcut settings.

Before installation, it is recommended to ensure the Pi environment is correctly configured and the Node.js version meets the requirements. Note that this Skill primarily replaces Pi's built-in editor and does not affect external terminals or other editing tools. For a richer experience that fully reuses existing Vim configurations, you can combine it with an external editor command bound to <leader>e.