refract.nvim

Neovim plugin for Refract — fast Ruby LSP server backed by SQLite.

Handles binary download and LSP registration. No Mason, no lspconfig, no Node.js.

Install

lazy.nvim

{
  "hrtsx/refract.nvim",
  build = function() require("refract").install() end,
  ft = { "ruby", "eruby", "haml" },
  opts = {},
}

build runs once on install and after updates. If the binary is already in your PATH, it is used directly and build is a no-op.

Manual (binary already in PATH)

{ "hrtsx/refract.nvim", ft = { "ruby", "eruby", "haml" }, opts = {} }

Configuration

require("refract").setup({
  -- Override binary path (default: auto-detect from PATH or managed install)
  path = nil,

  -- Passed to LSP initializationOptions
  init_options = {
    logLevel = 2,         -- 1=error 2=warn 3=info 4=debug
    disableRubocop = false,
    maxWorkers = 0,
  },

  -- File types that activate the server
  filetypes = { "ruby", "eruby", "haml" },
})

Commands

:lua require("refract").install()   -- download/update the binary

Requirements

• Neovim 0.8+
• curl in PATH (for binary download)