danprince / vsnetrw

🗂️ A split file explorer for vscode

vsnetrw

A split file explorer for vscode, inspired by netrw, vim-vinegar, dired, and vim-dirvish.

Shortcuts

Use vsnetrw.open to open a file explorer at the parent directory of the currently active text editor. Once open the following shortcuts are available.

Default Shortcut	Command	Description
enter	vsnetrw.openAtCursor	Open the file or directory under the cursor
-	vsnetrw.openParent	Jump to the parent directory
~	vsnetrw.openHome	Jump to the root of the current workspace folder, or user's homedir.
R	vsnetrw.rename	Rename the file or directory under the cursor
%	vsnetrw.create	Create a new file or directory (and any intermediate directories).
d	vsnetrw.createDir	Create a new directory (and any intermediate ones).
D	vsnetrw.delete	Delete the file or directory under the cursor.
ctrl+l	vsnetrw.refresh	Refresh the directory listing.
esc	vsnetrw.close	Close the active explorer.

VSCodeVim Keybindings

To make - open an explorer from any file (like vim-vinegar) add the following binding to your vim.normalModeKeyBindings.

{
  "before": ["-"],
  "commands": ["vsnetrw.open"],
  "when": "editorLangId != vsnetrw"
}

This binding can't be provided as part of the extension because native VSCode's keybindings will accidentally trigger in undesirable instances (e.g. pressing r- in normal mode).

Installation

vsnetrw can be installed from the VSCode Marketplace.

You can also download a VSIX from releases and install it by running >Extensions: Install from VSIX.