remote-ssh.nvim
A Neovim plugin that enables remote file editing with full LSP and TreeSitter support by running language servers on remote machines while keeping editing local.
What is remote-ssh.nvim?
Remote SSH for Neovim is a plugin that enables developers to edit files on remote servers with the full power of local Neovim editing. It solves the problem of network latency in remote development by running language servers on remote machines while keeping file editing completely local, providing instant keystroke response with accurate code intelligence.
Neovim users who develop on remote servers and need full LSP features without sacrificing editing responsiveness. This includes developers working with cloud-based development environments, remote containers, or team servers.
Developers choose this plugin because it eliminates the traditional trade-off between network latency and code intelligence in remote development. Unlike other solutions that either run everything remotely (causing lag) or locally (lacking project context), this hybrid approach provides the best of both worlds.
Overview
Remote SSH for Neovim provides a seamless remote development experience by combining local editing responsiveness with remote language server intelligence. It solves the common trade-off between network latency and code intelligence by fetching remote files to local buffers while executing language servers on the remote machine.
Key Features
- Zero-latency Editing — All keystrokes and cursor movements happen instantly on local buffers
- Full LSP Support — Code completion, go-to-definition, hover documentation, and error checking work seamlessly with remote language servers
- Remote File Explorer — Tree-based directory browsing with familiar navigation and rsync download capabilities
- Remote Terminal Management — VS Code-style integrated terminal with SSH connections and multi-terminal picker
- Remote Session Management — Unified workspace sessions with minimize/restore, persistence, and visual session picker
- File Change Detection — Automatically detects when remote files are modified by others with conflict resolution
- Telescope Integration — Enhanced search for remote buffers and file history
Philosophy
The plugin follows a hybrid approach that prioritizes local editing responsiveness while maintaining full access to remote project context through language servers, avoiding the traditional compromise between network latency and code intelligence.
Use Cases
Best For
- Editing remote C++ projects with clangd support
- Developing Python applications on cloud servers with pylsp
- Working with Rust codebases on remote machines using rust-analyzer
- Managing multiple remote development sessions with unified workspace control
- Browsing and editing remote files with full syntax highlighting and LSP features
- Running terminal applications on remote servers directly from Neovim
Not Ideal For
- Teams needing automatic sync of local Neovim config to remote servers (like remote-nvim.nvim offers)
- Environments where remote machines can't install language servers due to security locks
- Users who prefer a fully remote editing experience without local buffer management
- Production setups requiring rock-solid stability with no breaking changes
Pros & Cons
Pros
Keystrokes and cursor movements happen instantly on local buffers, eliminating network lag for editing—the README highlights this as a core benefit over traditional remote editing.
Code completion, go-to-definition, and error checking work seamlessly by running language servers on the remote machine, providing accurate project context without local compromises.
Includes a tree-based file explorer, terminal management, TUI sessions, and session pickers—all unified within Neovim for a VS Code-like remote workflow.
Automatically detects when remote files are modified by others with conflict resolution, preventing sync issues without manual intervention.
Cons
Requires passwordless SSH, language server installation on remotes, and multiple dependencies (Python, rsync)—the README admits this with extensive configuration steps and troubleshooting guides.
The plugin's own comparison section warns it 'has not yet reached maturity with breaking changes expected,' making it risky for stable production use.
LSP communication and file syncing rely on network quality; the README notes that 'performance depends on network connection quality,' which can lag on poor connections.
Open Source Alternative To
remote-ssh.nvim is an open-source alternative to the following products:
Frequently Asked Questions
Related Projects
distant.nvim🚧 (Alpha stage software) Edit files, run programs, and work with LSP on a remote machine from the comfort of your local environment 🚧
nvim-remote-containersDevelop inside docker containers, just like VSCode
nvim-dev-containerNeovim dev container support - Mirror of https://codeberg.org/esensar/nvim-dev-container
remote-sshfs.nvimExplore, edit, and develop on a remote machine via SSHFS with Neovim
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.