vim-symlink [](https://github.com/aymericbeaumet/vim-symlink/actions/workflows/ci.yml)

May 19, 2026 ยท View on GitHub

vim-symlink enables to automatically follow the symlinks in Vim or Neovim. This means that when you edit a pathname that is a symlink, vim will instead open the file using the resolved target path.

demo

Features

  • Cross-platform
  • Recursive symlinks resolution
  • vimdiff support
  • Allow to create new files in symlinked directories
  • Make vim-fugitive behave properly with linked files
  • Native Lua implementation for Neovim (0.7+) with VimScript fallback for Vim
  • No dependencies required
  • Runtime enable/disable via g:symlink_enabled
  • User SymlinkResolve event for custom hooks

Install

Install with lazy.nvim:

{ 'aymericbeaumet/vim-symlink' }

Install with packer:

use { 'aymericbeaumet/vim-symlink' }

Install with vim-plug:

Plug 'aymericbeaumet/vim-symlink'

Configuration

" Disable symlink resolution (default: 1)
let g:symlink_enabled = 0

" Disable redraw after resolution (default: 1)
let g:symlink_redraw = 0

Usage

Read more about the usage in the documentation.