A Visual Studio Code extension that provides a real-time preview of vim keybinding commands, acting as an interactive cheat sheet that responds to your keypresses.
- π Real-time preview of available vim commands and VSCODE keybinds
- β¨οΈ User-configurable trigger key
- β‘ Live filtering as you type
- π Support for custom binding descriptions
- π Search by keys, command IDs, or descriptions
- π Execute commands directly from the preview
Two ways to access the keybindings preview:
- Use the default shortcut:
ctrl+shift+v
- Open command palette (Cmd+Shift+P / Ctrl+Shift+P) and type "Show Vim Key Bindings Preview"
You can change the trigger key in VSCode settings:
- Open Settings (Cmd+, / Ctrl+,)
- Search for "VSCode Vim Preview"
- Edit the "Trigger Key" setting
- Enter your preferred key combination (e.g., "cmd+k cmd+v")
Once the preview is open:
- Type to filter available commands
- Search by:
- Key combinations (e.g., "ff" for leader+f+f)
- Command IDs (e.g., "quickOpen")
- Descriptions (if configured)
- Press Enter to execute the selected command
You can add descriptions to your keybindings to make them more discoverable:
"vim.normalModeKeyBindings": [
{
"description": "Write file",
"before": [",", "w"],
"commands": ["workbench.action.files.save"]
},
{
"description": "Quick file search",
"before": ["<leader>", "f", "f"],
"commands": ["workbench.action.quickOpen"]
}
]
The extension will use these descriptions in the preview interface, making it easier to find and understand your keybindings.
The extension supports:
- Custom leader key configurations
- Normal mode keybindings
- Visual mode keybindings
- Default VSCode Vim commands
- User-defined keybindings
- Visual Studio Code 1.95.0 or higher
- VSCode Vim extension installed and configured
vscode-vim-preview.triggerKey
: Key combination to trigger the preview (default: "ctrl+shift+v")
vim.leader
: Your configured leader keyvim.normalModeKeyBindings
: Your normal mode key mappingsvim.visualModeKeyBindings
: Your visual mode key mappings
None reported yet. Please submit issues on the GitHub repository.
- Added user-configurable trigger key
- Simplified extension functionality
- Improved reliability and vim compatibility
See CHANGELOG.md for full version history.
Contributions are welcome! Please feel free to submit a Pull Request.
This extension is licensed under the MIT License - see the LICENSE file for details.
Paurini Taketakehikuroa Wiringi