Neovim Configuration

Portable Neovim configuration using lazy.nvim, Mason-managed tooling, native LSP, native Treesitter, Telescope, and DAP (Neovim 0.11+, tested on 0.12.1).

Installation

Standalone (any system)

git clone git@github.com:itme-brain/nvim.git ~/.config/nvim

As part of NixOS config

git clone --recurse-submodules git@github.com:itme-brain/nixos.git

Plugin Lockfile

This config does not commit lazy-lock.json.

When Home Manager deploys this config from a flake, ~/.config/nvim can point into /nix/store, which is read-only. lazy.nvim normally writes its lockfile to stdpath("config"), so this config stores the runtime lockfile at stdpath("state") .. "/lazy-lock.json" instead.

Features

• Native LSP (vim.lsp.config / vim.lsp.enable) - no manual server list needed
• Smart LSP picker (<leader>css) - auto-detects installed servers for current filetype
• Neovim 0.12 compatible - uses built-in :lsp commands and keeps legacy :Lsp* aliases working
• Portable - Mason is the source of truth for LSP servers and debug adapters
• Treesitter - uses native vim.treesitter.* APIs with community fork provisioning
• Debugging - lazy-loaded nvim-dap stack with Mason-managed adapters

LSP Setup

Mason installs the shared LSP baseline on every system:

• lua_ls - Lua/Neovim
• nil_ls - Nix
• bashls - Bash/Shell
• jsonls - JSON
• html - HTML
• cssls - CSS
• marksman - Markdown
• taplo - TOML
• yamlls - YAML

On NixOS, Mason-installed binaries require nix-ld so downloaded tools can execute. The NixOS module should provide nix-ld; Neovim itself does not keep a separate Nix-only LSP package list.

The smart picker (<leader>css) scans all lspconfig servers and shows only those with binaries installed. On Neovim 0.12+, start/stop/restart uses the built-in :lsp commands under the hood.

Treesitter

Treesitter uses Neovim's native API:

• Highlighting starts through vim.treesitter.start
• Parser/filetype mappings use vim.treesitter.language.register
• Parsers and queries are provisioned by the community neovim-treesitter/nvim-treesitter fork

Neovim loads compiled parser libraries from parser/ directories on runtimepath and query files from queries/<language>/. tree-sitter-cli is only needed by the provisioner when installing or updating parsers; it is not required at runtime for highlighting. Mason bootstraps tree-sitter-cli when parser installation is needed.

Debugging

Debugging uses nvim-dap, nvim-dap-ui, nvim-dap-virtual-text, telescope-dap.nvim, and mason-nvim-dap.nvim.

The DAP stack is lazy-loaded. Normal startup does not load DAP; it loads only when a :Dap... command runs or a <leader>d... mapping is used.

Mason installs:

• debugpy - Python
• codelldb - C/C++/Rust
• bash-debug-adapter - Bash
• js-debug-adapter - JavaScript/TypeScript

Key Bindings

Key	Action
<leader>css	Start LSP (smart picker)
<leader>csx	Stop LSP
<leader>csr	Restart LSP
<leader>cf	Format code
<leader>ca	Code action
<leader>cr	Rename symbol
gd	Go to definition
<leader>gr	Find references
<leader>e	Toggle file explorer
<leader>bd	Delete buffer
<leader>/	Live grep from git root
<leader>ff	Find files from git root
<leader>db	Toggle breakpoint
<leader>dB	Set conditional breakpoint
<leader>dc	Continue debugging
<leader>di	Step into
<leader>do	Step over
<leader>dO	Step out
<leader>du	Toggle debug UI
<leader>dt	Terminate debug session
<leader>de	Evaluate expression
<leader>ds	Debug configurations
<leader>dS	Debug breakpoints

Plugins

• lazy.nvim - plugin manager
• nvim-lspconfig - LSP configurations
• nvim-cmp - completion
• telescope.nvim - fuzzy finder
• Native Treesitter - syntax highlighting
• neovim-treesitter - parser and query provisioning
• nvim-dap - debug adapter client
• nvim-dap-ui - debugging UI panes
• mason-nvim-dap.nvim - Mason debug adapter integration
• neo-tree.nvim - file explorer
• gitsigns.nvim - git integration
• lualine.nvim - statusline
• bufferline.nvim - buffer tabs
• which-key.nvim - keybinding hints