- Neovim >= 0.12 — check with
nvim --version. Starting Neovim on an older version shows a warning; treesitter highlighting and other features won't work. - A C compiler (
cc/gcc/clang) — to compile treesitter parsers. - The
tree-sitterCLI — the treesittermainbranch builds parsers with it. See Install the tree-sitter CLI.
Autocomplete works out of the box via buffer words. Install any of the following for language-specific autocomplete:
| Language | Binary | Install |
|---|---|---|
| Lua | lua-language-server |
brew install lua-language-server |
| PHP | phpactor |
composer global require phpactor/phpactor |
| JavaScript / TypeScript | typescript-language-server |
npm install -g typescript-language-server typescript |
Clone the repo:
git clone git@github.com:bluebirdday/neovim-config.git ~/.config/nvim
Start Neovim with nvim. On first launch, lazy.nvim bootstraps and installs the
plugins. Then build the treesitter parsers and verify:
:Lazy sync
:TSUpdate
:checkhealth nvim-treesitter:checkhealth should report no errors (a C compiler + the tree-sitter CLI must be
on PATH). Open a file (e.g. a .php) to confirm syntax highlighting works.
The treesitter main branch needs the tree-sitter CLI to build parsers.
On managed hosting npm install -g usually fails with EACCES (no root). Drop a
prebuilt binary into a directory already on your PATH instead (x86_64 Linux):
mkdir -p ~/.local/bin
curl -L https://github.com/tree-sitter/tree-sitter/releases/download/v0.25.10/tree-sitter-linux-x64.gz \
| gunzip > ~/.local/bin/tree-sitter
chmod +x ~/.local/bin/tree-sitter
tree-sitter --version(If ~/.local/bin isn't on your PATH, add export PATH="$HOME/.local/bin:$PATH"
to your shell rc.)
Why pin v0.25.10 instead of
latest? The newest binaries (v0.26+) are built against glibc 2.39 and fail on Debian 12 (Bookworm, glibc 2.36) withversion 'GLIBC_2.39' not found. v0.25.10 only needs glibc 2.34 and has thetree-sitter buildcommand this config relies on. On a newer distro (glibc >= 2.39) you can uselatest; on an older one, pick a version whose required glibc fits (check withstrings tree-sitter | grep GLIBC_ | sort -V | tail -1).
npm config set prefix "$HOME/.local"
npm install -g tree-sitter-clisudo add-apt-repository ppa:neovim-ppa/unstable
sudo apt-get update
sudo apt-get install neovim
Download a Neovim >= 0.12 release and symlink the binary into ~/.local/bin
(adjust the version/paths as needed):
mkdir -p ~/bin
cd ~/bin
wget https://github.com/neovim/neovim/releases/download/v0.12.1/nvim-linux-x86_64.tar.gz
tar xzvf nvim-linux-x86_64.tar.gz
mkdir -p ~/.local/bin
ln -sf ~/bin/nvim-linux-x86_64/bin/nvim ~/.local/bin/nvim- Plugins (via lazy.nvim): lualine, bufferline, nvim-tree, telescope (+ fzf), treesitter, render-markdown, which-key, mini.nvim (completion + snippets), tokyonight colorscheme, tmux-navigator.
- LSP: enables the
luals,php, andts_lsconfigs inlsp/(lua-language-server, phpactor, typescript-language-server) when their binaries are present — addsgd,<leader>d, on top of Neovim's built-in 0.11+ LSP keymaps. - Clipboard: yank (
y/Y) goes to the system clipboard; delete/change (d/c/x) stay in Vim's own registers (no clipboard pollution, still pasteable withp). Over SSH this uses OSC 52, so yanks reach your local machine's clipboard. - Keymaps & options: see CHEATSHEET.md for the full keybinding list.
- Mouse enabled in all modes; relative line numbers; persistent undo; treesitter
syntax highlighting for lua, php, js/ts, html, css, xml, yaml, json, twig, markdown,
and shell scripts (bash;
.zshfiles use the bash parser too).