Skip to content

mikew/nvrh

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

59 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nvrh

demo.client.open.mov.mp4

nvrh (Neovim Remote Helper) aims to provide a simple way of working with a remote Neovim instance, like you would with VSCode Remote.

Installation

Download the nvrh binary for your platform / architecture from the latest release.

Rename it to nvrh and put it somewhere on your PATH for convenience.

Features

  • Start Neovim on a remote machine.
  • Tunnel the connection between your local and remote machines.
  • Start your editor locally, talking to your remote Neovim instance.
  • Provide an easy way to tunnel ports.
  • Provide an easy way to open URLs on your local machine.

Usage

nvrh client open

This will open a new Neovim instance on your remote machine and connect to it from your local machine.

NAME:
   nvrh client open - Open a remote nvim instance in a local editor

USAGE:
   nvrh client open [command options] <server> [remote-directory]

CATEGORY:
   client

OPTIONS:
   --ssh-path value                               Path to SSH binary. 'binary' will use the default system SSH binary. 'internal' will use the internal SSH client. Anything else will be used as the path to the SSH binary (default: "binary") [$NVRH_CLIENT_SSH_PATH]
   --use-ports                                    Use ports instead of sockets. Defaults to true on Windows (default: false) [$NVRH_CLIENT_USE_PORTS]
   --debug                                        (default: false) [$NVRH_CLIENT_DEBUG]
   --server-env value [ --server-env value ]      Environment variables to set on the remote server [$NVRH_CLIENT_SERVER_ENV]
   --local-editor value [ --local-editor value ]  Local editor to use. {{SOCKET_PATH}} will be replaced with the socket path (default: "nvim", "--server", "{{SOCKET_PATH}}", "--remote-ui") [$NVRH_CLIENT_LOCAL_EDITOR]
   --nvim-cmd nvim [ --nvim-cmd nvim ]            Command to run nvim with. Defaults to nvim (default: "nvim") [$NVRH_CLIENT_NVIM_CMD]
   --ssh-arg value [ --ssh-arg value ]            Additional arguments to pass to the SSH command [$NVRH_CLIENT_SSH_ARG]
   --enable-automap-ports                         Enable automatic port mapping (default: true) [$NVRH_CLIENT_AUTOMAP_PORTS]
   --help, -h                                     show help

By default it runs nvim, but you can run something else with

nvrh client open \
  --local-editor nvim-qt \
  --local-editor --nofork \
  --local-editor --server \
  --local-editor {{SOCKET_PATH}}

nvrh client reconnect

Reconnect to an existing nvrh session.

NAME:
   nvrh client reconnect - Reconnect to an existing remote nvim instance

USAGE:
   nvrh client reconnect [command options] <server> <session-id>

CATEGORY:
   client

OPTIONS:
   --ssh-path value                               Path to SSH binary. 'binary' will use the default system SSH binary. 'internal' will use the internal SSH client. Anything else will be used as the path to the SSH binary (default: "binary") [$NVRH_CLIENT_SSH_PATH]
   --use-ports                                    Use ports instead of sockets. Defaults to true on Windows (default: false) [$NVRH_CLIENT_USE_PORTS]
   --debug                                        (default: false) [$NVRH_CLIENT_DEBUG]
   --local-editor value [ --local-editor value ]  Local editor to use. {{SOCKET_PATH}} will be replaced with the socket path (default: "nvim", "--server", "{{SOCKET_PATH}}", "--remote-ui") [$NVRH_CLIENT_LOCAL_EDITOR]
   --ssh-arg value [ --ssh-arg value ]            Additional arguments to pass to the SSH command [$NVRH_CLIENT_SSH_ARG]
   --help, -h                                     show help

:NvrhTunnelPort

demo.tunnel.port.mov.mp4

nvrh adds a :NvrhTunnelPort command to Neovim to tunnel a port between your local and remote machines.

:NvrhTunnelPort 8080
:NvrhTunnelPort 4000

:NvrhOpenUrl

demo.browser.env.var.mov.mp4

nvrh adds a :NvrhOpenUrl command to Neovim to open a URL on your local machine.

:NvrhOpenUrl https://example.com

In addition to this command, it also sets the BROWSER environment variable, so commands can open a browser on your local machine.

About

Aims to be similar to VSCode Remote, but for Neovim

Topics

Resources

License

Stars

Watchers

Forks

Contributors 2

  •  
  •