// the find
folke/trouble.nvim
🚦 A pretty diagnostics, references, telescope results, quickfix and location list to help you solve all the trouble your code is causing.
trouble.nvim is a Neovim panel that replaces the built-in quickfix and location list with a tree-based, properly formatted view. It also surfaces LSP diagnostics, references, document symbols, and results from fuzzy finders like Telescope and fzf-lua in one consistent UI. It's for Neovim users who find the default quickfix window ugly and hard to navigate.
The mode system is genuinely well-designed — you can define custom views by composing filters, sorters, and sections, so it's not just a skin on quickfix but an actual data pipeline. The throttle/debounce configuration being exposed is a nice touch for users who want to tune refresh performance on large codebases. Integration with both Telescope and fzf-lua means you can send any search result into Trouble without friction, and those results stay live. The statusline component for document symbols is a practical addition that most competing plugins don't have.
The config object is massive and the defaults section is a wall of undocumented fields — understanding what `max_items = 200` does to a split-window view versus a float requires reading source code. The test suite is thin: two spec files covering the parser and spec modules, nothing that exercises actual LSP interaction or rendering, so regressions in the view layer will only surface in users' configs. The v2 rewrite broke nearly every v1 config, and the migration path in the docs is minimal — if you find a config snippet online it's probably wrong for the current API. It also requires a Nerd Font for the default icons, which is a silent failure mode if you're on a plain terminal.