wom/wombient

wombient.nvim is a plugin for the Neovim text editor that makes long files easier to scan. It shades nested sections of code with subtle background colors and an optional stripe down the left side, so you can see where one block of code ends and another begins, without changing your normal syntax highlighting colors. To figure out where sections start and end, wombient first tries semantic tools built into your editor setup: Tree-sitter, which understands the structure of your code, and folding ranges reported by a language server if one is attached. If neither of those is available it falls back to simpler pattern matching, such as recognizing YAML keys that open a block, common Python keywords like def and class, or general indentation rules. Different file types can be configured to use different chains of these strategies. The plugin needs Neovim version 0.10 or newer. Tree-sitter parsers and a language server are both optional extras that improve accuracy but are not required, since the indentation based fallback works on its own. Installation is shown for the lazy.nvim plugin manager, either pulling the plugin straight from its GitHub repository or pointing lazy.nvim at a local copy of the code for development. Once installed you call a setup function to configure it, then use editor commands to toggle, enable, or disable the shading. The README documents a long list of options: which strategy chain to use per file type, whether to show the left stripe and what character it uses, the color palettes used for dark and light backgrounds, which file types and buffer types to skip, and how often the shading refreshes as you edit. No default keyboard shortcuts are created, so you set your own if you want them. The project also exposes a small Lua API for calling these actions directly from your own configuration.