Browse and filter diagnostics, then jump to the affected code.
Good to know
Requires diagnostic providers and diagnostic highlight groups.
Unclaimed
Are you @folke?Claim it, and your coding agent keeps it current with each release
Written by 
Are you @folke?Claim it, and your coding agent keeps it current with each release
Browse diagnostics, navigate LSP results, and revisit search results in configurable Neovim lists.
What you can do with Trouble
Navigate definitions, references, implementations, declarations and type definitions.
1 other tool for: Jump to definitionsGood to know
Requires a configured LSP client supporting the requested method.
Browse a document's symbols in a hierarchical list.
Good to know
Requires LSP document-symbol support.
Browse incoming and outgoing calls and jump to their locations.
Good to know
Requires a language server with call-hierarchy support.
Browse and jump through quickfix and location-list entries.
Good to know
Requires a populated quickfix or location list.
Keep Telescope search results in a Trouble list and append later results.
Good to know
Requires Telescope and a mapping to the Trouble integration.
Arrange filtered results in multiple floating or split views with previews and custom key mappings.
Good to know
Views default to 200 items per section; icons require a patched font.
Show symbols for the current cursor position in a statusline.
Good to know
Requires LSP document symbols and statusline configuration.
Show all 11
Open or append selected fzf-lua results, using all results when nothing is selected.
Good to know
Requires fzf-lua and a mapping to the Trouble integration.
Identify files in result lists using mini.icons or nvim-web-devicons icons.
Good to know
Requires mini.icons or nvim-web-devicons and a suitable font.
Open or append selected Snacks picker results, or all filtered results when nothing is selected.
Good to know
Requires Snacks picker and configuration of Trouble picker actions.
Before you upgrade Trouble
Newest first`mini.icons` is tried before `nvim-web-devicons` when choosing a file icon provider.
Read the evidence
Move global `auto_open = true` into the desired mode, for example `modes.diagnostics.auto_open = true`; global `auto_open` is now disabled.
Read the evidence
Rename custom `TroubleFileName` highlights to `TroubleFilename`; `TroubleBasename` now links to `TroubleFilename`.
Read the evidence
Diagnostic codes use the `code` formatter and `TroubleCode` highlight; parentheses are shown only when a code exists. Custom formats should use `{code}` without extra parentheses.
Read the evidence
Trouble release history 7
Request LSP locations using each language server's position encoding.
Details
Location and call-hierarchy requests pass each client's offset encoding when constructing position parameters.
Install folke/trouble.nvim at v3.7.1 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Now works / inferred: Navigate definitions, references, implementations,…Now works / inferred: Browse incoming and outgoing calls and jump to thei…
Seeded by @iluxav with Codex
Read the evidence
Keep selected or filtered Snacks picker results in a Trouble list.
Details
Added Snacks picker actions and jump_split_close/jump_vsplit_close. Diagnostic signs configured as booleans and symbol names overridden by other plugins are handled.
Install folke/trouble.nvim at v3.7.0 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Added: Open or append selected Snacks picker results, or a…Improved: Arrange filtered results in multiple floating or sp…Now works: Browse and filter diagnostics, then jump to the aff…Now works / inferred: Browse a document's symbols in a hierarchical list.
Seeded by @iluxav with Codex
v3.6.0
with v3.5.2
with v3.5.2
Disable individual Trouble key mappings in your configuration.
Details
Key mappings accept false to disable a binding. Notification formatting targets the notification window, and deferred highlighting skips closed buffers.
Install folke/trouble.nvim at v3.6.0 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Improved / inferred: Arrange filtered results in multiple floating or sp…Now works / inferred: Browse and filter diagnostics, then jump to the aff…
Seeded by @iluxav with Codex
v3.5.1
with v3.5.0
with v3.5.0
Display file icons supplied by mini.icons in Trouble lists.
Details
Added mini.icons support and fixed Telescope paths and line-only locations. Ruff diagnostics with null codes, incoming-call labels, and option completion with numeric keys are handled.
Install folke/trouble.nvim at v3.5.1 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Added: Identify files in result lists using mini.icons or…Behavior changed / inferred: Identify files in result lists using mini.icons or…Now works / inferred: Keep Telescope search results in a Trouble list and…Now works / inferred: Browse and filter diagnostics, then jump to the aff…Now works: Browse incoming and outgoing calls and jump to thei…Now works / inferred: Arrange filtered results in multiple floating or sp…
Seeded by @iluxav with Codex
Read result text from CRLF files without a trailing carriage return.
Details
Result text strips CRLF line endings, unnamed buffers receive a display name, and platform checks support Neovim versions exposing vim.loop instead of vim.uv.
Install folke/trouble.nvim at v3.4.3 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Now works / inferred: Arrange filtered results in multiple floating or sp…Now works / inferred: Open or append selected fzf-lua results, using all…
Seeded by @iluxav with Codex
Read the evidence
v3.4.2
with v3.4.0, v3.4.1
with v3.4.0, v3.4.1
Keep selected or all fzf-lua results in a Trouble list.
Details
Added fzf-lua actions and automatic file-only Telescope views. Fixed automatic opening and window handling; global auto_open and filename highlight customizations need changes.
Install folke/trouble.nvim at v3.4.2 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Added: Open or append selected fzf-lua results, using all…Action required: Arrange filtered results in multiple floating or sp…Now works / inferred: Arrange filtered results in multiple floating or sp…Now works: Keep Telescope search results in a Trouble list and…Action required / inferredBehavior changed / inferred: Browse and filter diagnostics, then jump to the aff…
Seeded by @iluxav with Codex
Read the evidence
- folke/trouble.nvim/blob/v3.4.0/lua/trouble/sources/fzf.lua
- folke/trouble.nvim/blob/v3.4.0/lua/trouble/config/init.lua
- folke/trouble.nvim/blob/v3.4.2/lua/trouble/view/init.lua
- folke/trouble.nvim/releases/tag/v3.4.0
- folke/trouble.nvim/blob/v3.4.2/lua/trouble/config/highlights.lua
- folke/trouble.nvim/blob/v3.4.2/lua/trouble/format.lua
v3.3.0
Starting point
Starting point
Browse diagnostics and jump to the affected code from a Neovim list.
Details
Baseline before the last ten releases: Trouble provides diagnostic, LSP, quickfix, location-list and Telescope views, configurable windows, previews and a statusline component.
Install folke/trouble.nvim at v3.3.0 with a Neovim plugin manager. Requires Neovim >= 0.9.2 and either Neovim >= 0.10.0 or markdown and markdown_inline Treesitter parsers.
Added: Browse and filter diagnostics, then jump to the aff…Added: Navigate definitions, references, implementations,…Added: Browse a document's symbols in a hierarchical list.Added: Browse incoming and outgoing calls and jump to thei…Added: Browse and jump through quickfix and location-list…Added: Keep Telescope search results in a Trouble list and…Added: Arrange filtered results in multiple floating or sp…Added: Show symbols for the current cursor position in a s…
Seeded by @iluxav with Codex