A batteries-included Neovim configuration built on the NvChad distribution. Designed with a minimal UI philosophy while providing comprehensive out-of-the-box support for modern development workflows.
It features:
- Minimal UI — Clean interface with thoughtfully designed key mappings
- Multi-language Support — 18 languages with varying LSP, formatting, and linting support
- Debugging — Integrated DAP support for Go and Python
- AI Agent — Built-in OpenAI Codex support via ACP
- Markdown Preview — Live preview of Markdown files
- Git Integration — Visual commit history and diff tools
| Language | LSP | Formatter | Linter | Debugger |
|---|---|---|---|---|
| Go | gopls | goimports | golangci-lint | delve |
| Python | pyright | black, isort | pylint | debugpy |
| C/C++ | clangd | clang-format | — | — |
| Lua | lua-language-server | stylua | — | — |
| Ruby | ruby-lsp | rubocop | rubocop | — |
| TypeScript/JavaScript | typescript-language-server | prettier | — | — |
| HTML/CSS/SCSS | html-lsp, css-lsp | prettier | — | — |
| JSON | json-language-server | prettier | — | — |
| GraphQL | — | prettier | — | — |
| YAML | yaml-language-server | prettier | — | — |
| Markdown | marksman | prettier | markdownlint | — |
| Bash | bash-language-server | shfmt | ShellCheck | — |
| Dockerfile | dockerfile-language-server | dockerfmt | hadolint | — |
| Terraform | terraform-ls | terraform_fmt | tflint | — |
| TOML | taplo | taplo | — | — |
| Makefile | — | bake | checkmake | — |
| Vimscript | vim-language-server | — | — | — |
| SQL | — | sql-formatter | — | — |
| Dependency | Version | Notes |
|---|---|---|
| Neovim | 0.12.0+ | Required |
| Nerd Font | Any | Hack Nerd Font recommended |
| Ripgrep | Latest | For fuzzy finding |
| Node.js/npm | Latest | Required by ACP |
| Codex ACP | Latest | Required for AI agent |
| Terraform | Latest | Optional, for Terraform support |
# Backup and remove existing config
mv ~/.config/nvim ~/.config/nvim.bak
mv ~/.local/share/nvim ~/.local/share/nvim.bak
# Clone and install
git clone https://github.com/le4ker/NvMegaChad ~/.config/nvim
cd ~/.config/nvim
make install
nvimgit clone git@github.com:le4ker/NvMegaChad ~/.config/le4ker/NvMegaChad
cd ~/.config/le4ker/NvMegaChad
make install
NVIM_APPNAME=le4ker/NvMegaChad nvimRun the isolated config helper tests with:
make testRun only the specs whose path contains a substring with SPEC:
make test SPEC=python_envSpecs mirror the lua/ tree: lua/utils/python_env.lua is covered by
tests/utils/python_env_spec.lua. Checks that span several files, such as startup and the
consistency of the plugin, Mason and tool lists, live in tests/integration/, and fakes shared
between specs live in tests/support/.
Install the local test and commit-message hooks with make hooks. The test
suite also runs on every push and pull request in GitHub Actions.
See LICENSE for details.