Skip to content

🚧 (Alpha stage software) Edit files, run programs, and work with LSP on a remote machine from the comfort of your local environment 🚧

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT
Notifications You must be signed in to change notification settings

chipsenkbeil/distant.nvim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

distant.nvim

CI

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 if distant 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.

About

🚧 (Alpha stage software) Edit files, run programs, and work with LSP on a remote machine from the comfort of your local environment 🚧

Topics

Resources

License

Apache-2.0, MIT licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

No packages published

Languages