tiny-lightbulb.nvim

A tiny lightbulb for Neovim 0.12+. Shows a sign when LSP code actions are available on the current line.

Zero config. ~40 lines of Lua.

Features

Displays a 💡 in the sign column when code actions are available
Clears instantly on cursor move
Async LSP requests with stale-response handling
Configurable sign text and highlight group
Works out of the box — no setup call required

Requirements

Neovim >= 0.12
At least one LSP server that supports code actions

Installation

Add to your vim.pack.add() call:

"https://github.com/swaits/tiny-lightbulb.nvim",

Done. The plugin auto-loads with sensible defaults.

Recommended setup

To prevent the gutter from expanding and contracting as the lightbulb appears and disappears, reserve the sign column width up front:

vim.o.signcolumn = "yes:2"  -- room for a diagnostic + the lightbulb

Without this, Neovim's default auto behavior will shift your text left and right as signs come and go.

Configuration

All options are optional. Call setup() only if you want to customize:

require("tiny-lightbulb").setup({
  sign = "💡",           -- sign column text
  hl = "DiagnosticWarn",  -- highlight group
})

How it works

On CursorHold, the plugin asks all attached LSP clients whether code actions exist for the current line. If any are returned, an extmark sign is placed. On CursorMoved, the sign is cleared and any in-flight LSP responses are discarded via a generation counter.

License

MIT

1.5 KiB Raw Blame History