Skip to content

danprince/vsnetrw

Repository files navigation

vsnetrw

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

vsnetrw in action

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.