distant.nvim
A wrapper around distant
that
enables users to edit remote files from the comfort of their local environment.
- Requires neovim 0.8+
- Requires distant 0.20.x
Visit https://distant.dev/editors/neovim/ for full documentation!
π§ (Alpha stage software) This plugin is in rapid development and may break or change frequently! π§
Installation
lazy.nvim
{
'chipsenkbeil/distant.nvim',
branch = 'v0.3',
config = function()
require('distant'):setup()
end
}
packer.nvim
use {
'chipsenkbeil/distant.nvim',
branch = 'v0.3',
config = function()
require('distant'):setup()
end
}
vim-plug
Plug 'chipsenkbeil/distant.nvim', {
\ 'branch': 'v0.3',
\ 'do': ':lua require("distant"):setup()'
\ }
Post-installation
If you already have
distant
installed with a version that is compatible with the plugin, this step can be skipped. You can verify ifdistant
is installed correctly by running:checkhealth distant
.
Execute :DistantInstall
.
A prompt will be provided where you can download a pre-built binary for your
local machine that will be placed in ~/.local/share/nvim/distant/
on Unix
systems or ~\AppData\Local\nvim-data\distant\
on Windows.
You can verify that it is available by running :DistantClientVersion
.
See the neovim installation guide for more information.
Installing on your server
If you want to just use distant to connect to an ssh server, you can skip this and the remaining steps and use
:DistantConnect ssh://example.com
.
Log into your remote machine and run this command to download a script to run to install distant. In this example, we'll use ssh to install distant on a Unix-compatible server (example.com):
ssh example.com 'curl -L https://sh.distant.dev | sh -s -- --on-conflict overwrite'
See the distant CLI installation guide for more information.
License
This project is licensed under either of
Apache License, Version 2.0, (LICENSE-APACHE or apache-license) MIT license (LICENSE-MIT or mit-license) at your option.