jasonwilliams / vscode-helix

MIT License
178 stars 9 forks source link

Helix for VS Code

   


This is a Visual Studio Code implementation of Helix Keybindings and Commands. I created this because I wanted to use Helix in VS Code and was frustrated with the built-in commands not being ergonomic. I didn't want to move fully unto helix and lose the benefits of VS Code, so I decided to create this extension.

It is a work in progress, feel free to raise issues or contribute on the issue tracker.

Installation

You can find the extension on the VS Code Marketplace.

Commands

The main commands should work but selections currently do not.

Right now commands are hardcoded to the default keymap, hopefully this can be adjusted to the user's keymap in the future.

If something doesn't work, please open an issue.

Performance

For added performance, you can try adding the following setting, and reload/restart VSCode:

"extensions.experimental.affinity": {
  "jasew.vscode-helix-emulation": 1
}

Differences

There will be some differences between this extension and native Helix, these will be due:

Window Mode

Due to VS Code having tabs I've needed to add some new windows modes on top of the current Helix ones, these commands are based around movements, (i.e moving the editor from one window to another).

Command Description
ctrl + w, m, v Move editor to the next group vertically (to the right)
ctrl + w, m, s Move editor to the next group horizontally (below)
ctrl + w, m, p Move editor back to the previous group
ctrl + w, m, w Move editor out into a new window (experimental)
ctrl + w, m, j Rejoin editor with main window (experimental)
ctrl + w, c Close window (alias to ctrl + w, q)
ctrl + w, n New untitled editor (prev ctrl+n/cmd+n in VS Code)
ctrl + w, b Toggle sidebar visibility (prev ctrl+b in VS Code)

Most of the differences will be related to the fact VSCode doesn't have TreeSitter or have access to an AST. So we often need to find other ways of achieving the same action.

Movements

Command Description
alt + k Move lines or selection up
alt + j Move lines or selection down
alt + d Add selection to next match (same as ctrl+d)
alt + m Move selection to next match (same as ctrl+k)

Outstanding

Feel free to pick up any of these if you wanted to contribute.

Insert Mode