nvim-zen

Deterministic Neovim configuration optimized for low startup overhead, explicit behavior, and OS-managed tooling.

Requirements

• Neovim 0.12+
• git
• rg
• fd
• LSP binaries in PATH:
  • gopls
  • pyright-langserver
  • typescript-language-server
  • terraform-ls
  • yaml-language-server
• Formatter binaries in PATH:
  • stylua
  • black
  • shfmt
  • gofmt
  • terraform

Install all of the above with your OS package manager, or run the bootstrap script below.

Bootstrap

1. Clone this repository.
2. Run bootstrap once:

./scripts/bootstrap.sh

3. (Optional) Add machine-local overrides:

cp lua/machine/example.lua lua/machine/local.lua

4. Start Neovim. Pinned plugins are installed by mini.deps.

Features

• Completion via nvim-cmp for LSP, buffer, path, and command line.
• Diagnostics shown in signs/underline, with float on CursorHold and InsertLeave.
• Optional GitHub Copilot integration via lua/machine/local.lua.

Enable Copilot locally:

-- lua/machine/local.lua
return {
  enable_copilot = true,
}

Operational model

• No plugin manages external binaries.
• Tooling requirements are validated at startup and reported via warning if missing.
• LSP and formatter definitions are centralized in lua/infra/spec.lua.
• Plugin versions are pinned in lua/infra/deps.lua.
• Treesitter only provides highlight and basic indentation.

Debugging

• Run :ZenHealth to re-check dependency availability.
• Startup time warns when it exceeds the 20ms target.