mason/doc, branch feat/socket-integration

feat: add support for socket.dev firewall client

2026-05-16T15:55:06Z

feat: add the infrastructure to support "system" packages (#2085)

2026-05-14T15:21:42Z

This enables `mason.nvim` to start managing certain packages that: 1) are not suitable for the core registry 2) should not surface in existing APIs and UIs

feat(npm): add `install_args` setting (#1581)

2026-04-21T13:26:46Z

Co-authored-by: William Boman

docs: rework Installation & Setup sections, and other minor adjustments (#1951)

2025-05-20T10:26:06Z

docs: update references to mason-org/mason.nvim (#1925)

2025-05-06T21:30:27Z

feat(ui): support 'winborder'

2025-04-21T21:39:00Z

chore!: update required Neovim version to 0.10.0

2025-02-19T11:15:49Z

refactor!: change Package API

2025-02-19T11:15:48Z

This changes the following public APIs: **(_breaking_) Events on the `Package` class** The `uninstall:success` event on the `Package` class now receives an `InstallReceipt` as argument, instead of an `InstallHandle`. This receipt is an in-memory representation of what was uninstalled. There's also a new `uninstall:failed` event for situations where uninstallation for some reason fails. Note: this also applies to the registry events (i.e. `package:uninstall:success` and `package:uninstall:failed`). --- **(_breaking_) `Package:uninstall()` is now asynchronous and receives two new arguments, similarly to `Package:install()`** While package uninstallations remain synchronous under the hood, the public API has been changed from synchronous -> asynchronous. Users of this method are recommended to provide a callback in situations where code needs to execute after uninstallation fully completes. --- **(_breaking_) `Package:get_install_path()` has been removed. --- **`Package:install()` now takes an optional callback** This callback allows consumers to be informed whether installation was successful or not without having to go through a different, low-level, API. See below for a comparison between the old and new APIs: ```lua -- before local handle = pkg:install() handle:once("closed", function () -- ... end) -- after pkg:install({}, function (success, result) -- ... end) ```

refactor: standardize constructors and improve inheritance construction

2025-02-19T08:23:19Z

refactor!: refactor installer internals and add new Package class methods (#1523)

2025-02-19T08:22:40Z

This contains the following changes: 1) `Package:install()` now accepts a second, optional, callback argument which is called when installation finishes (successfully or not). 2) Adds a `Package:is_installing()` method. This contains the following breaking changes: 1) `Package:install()` will now error when called while an installation is already ongoing. Use the new `Package:is_installing()` method to check whether an installation is already running. This also refactors large portions of the tests by removing test globals, removing async_test, and adding the `mason-test` Lua module instead. Test helpers via globals are problematic to work with due to not being detected through tools like the Lua language server without additional configuration. This has been replaced with a Lua module `mason-test`. `async_test` has also been removed in favour of explicitly making use of the `mason-core.async` API. These changes stands for a significant portion of the diff.

feat!: upgrade minimum required neovim version to 0.9.0 (#1517)

2025-02-16T08:49:17Z

refactor!: consolidate Lua registry sources and the Package API (#1498)

2025-02-16T08:48:59Z

**This removes the following APIs:** - `Package:check_new_version()`. Instead use the new `Package:get_latest_version()`. **This has a breaking change in the following APIs:** - `Package:get_installed_version()` now no longer takes a callback but instead returns the installed version or `nil` if not installed.

To handle these breaking changes in plugins, leverage the `mason.version` module, for example:

```lua local mason_version = require("mason.version") local registry = require("mason-registry") local pkg = registry.get_package("rust-analyzer") if mason_version.MAJOR_VERSION < 2 then -- before pkg:check_new_version(function (success, new_version) -- … end) pkg:get_installed_version(function (success, installed_version) -- … end) else -- after local new_version = pkg:get_latest_version() local installed_version = pkg:get_installed_version() fi ```

---

This change also introduces breaking changes for Lua registry sources, by consolidating the package schema with the registry.

The following is an example of a package defined in a Lua registry, following the new schema: ```lua local Pkg = require("mason-core.package") return Pkg.new { schema = "registry+v1", name = "ripgrep", description = "ripgrep recursively searches directories for a regex pattern while respecting your gitignore.", homepage = "https://github.com/BurntSushi/ripgrep", licenses = { Pkg.License.MIT }, languages = {}, categories = {}, source = { id = "pkg:mason/ripgrep@13.0.0", ---@param ctx InstallContext ---@param purl Purl install = function(ctx, purl) -- Arbitrary installation code. end, }, bin = { rg = "./bin/rg", }, } ```

feat(ui): add backdrop (#1759)

2025-02-15T22:12:31Z

Adds a backdrop for the Mason window. Can be disabled by setting the `ui.backdrop` option: ```lua require("mason").setup { ui = { backdrop = 100 } } ``` The backdrop is not displayed if `'termguicolors'` is not enabled or if Neovim is transparent. Co-authored-by: William Boman

docs: update default settings docs (#1470)

2023-08-26T13:57:53Z

docs: update help docs (#1370)

2023-06-27T08:47:44Z

feat(registry): add .get_all_package_specs() (#1247)

2023-04-22T17:20:52Z

This is a faster method than .get_all_packages() due to the fact that it only loads package specifications without instantiating mason-core.package instances. Useful for situations where one only needs to read spec data.

chore: remove lua:mason-registry.index registry entry (#1243)

2023-04-21T19:33:02Z

docs: update default settings (#1114)

2023-03-19T15:16:20Z

fix(doc): duplicate helptag (#1099)

2023-03-14T05:42:36Z

Closes #1098.

feat: add registry.refresh() method (#1096)

2023-03-14T03:48:03Z

style: enforce import order (#1092)

2023-03-12T08:26:02Z

* chore(workflows): update dependencies * style: enforce import order

feat: add github registry source capabilities (#1091)

2023-03-12T07:21:15Z

feat: configurable registries (#1016)

2023-02-20T21:19:39Z

docs: fix default value for `ui.height` (#914)

2023-01-16T10:24:29Z

feat(ui): customizable window height and width (#906)

2023-01-15T18:18:45Z

docs(reference): add section regarding registry events (#848)

2023-01-04T08:37:46Z

feat(registry): add has_package() method (#847)

2023-01-04T06:28:35Z

fix(powershell): use pwsh if available (#782)

2022-12-21T10:51:36Z

Revert "chore: use pwsh instead of powershell (#706)" (#769)

2022-12-19T10:06:58Z

This reverts commit e64dffb84e84e67836a05707a95b1d81fe698481.

docs: add more helpfile tips (#716)

2022-12-02T13:41:56Z

Probably helpful for some people.

docs: some general improvements (#715)

2022-12-02T13:28:37Z

chore: use pwsh instead of powershell (#706)

2022-11-29T15:49:56Z

docs: annotate language blocks for syntax highlighting (#686)

2022-11-23T07:40:04Z

feat(pip): add setting to upgrade pip before installing packages (#671)

2022-11-16T18:59:10Z

Closes #616.

docs: update mason-errors help section (#646)

2022-11-08T12:32:13Z

feat: add provider interface (#601)

2022-10-30T16:43:46Z

docs: improve quickstart (#592)

2022-10-23T14:06:37Z

feat: add setting to control PATH modification (#514)

2022-10-05T23:05:50Z

Closes #509.

docs: add some more vimdocs (#429)

2022-09-15T23:15:44Z

docs(reference): add some more notes to `Package:check_new_version()` (#352)

2022-08-28T12:22:23Z

chore: add cbfmt config (#328)

2022-08-25T01:21:13Z

docs: note that event handlers may be executed outside of the main loop (#297)

2022-08-15T19:08:20Z

feat(ui): check for new package versions when opening :Mason (#285)

2022-08-11T22:34:52Z

docs: change to a more appropriate word (#268)

2022-08-08T11:47:02Z

In this case, using `packages` instead of `languages` makes more sense. In the example given, we're not installing just "languages" but also other packages (a formatter)

docs: add :help mason.nvim to README (#259)

2022-08-06T12:23:10Z

docs: add section describing how to use packages (#206)

2022-07-31T11:43:50Z

docs: add CONTRIBUTING.md, SECURITY.md and update doc/reference.md (#181)

2022-07-28T13:48:48Z

stable branch release

2022-07-24T13:06:55Z

docs: fixup the mason.txt help (#115)

2022-07-22T12:29:42Z

docs: update setup section (#110)

2022-07-22T01:20:05Z

refactor!: extract mason-lspconfig to separate plugin (#109)

2022-07-22T01:15:43Z

The rationale behind this is to make boundaries clearer as mason.nvim has no direct relation with lspconfig per se. Also, hopefully, by having it as a separate package like this would encourage more people to write similar extensions (think mason-dap and mason-null-ls). Ideally such extensions wouldn't be required at all, but there are definitely gaps to fill as of today. From now on you'll need to add `williamboman/mason-lspconfig.nvim` as a plugin if you want to use the `mason-lspconfig` extension: ```lua use { { "williamboman/mason.nvim", branch = "alpha" }, "williamboman/mason-lspconfig.nvim", "neovim/nvim-lspconfig", } ``` ```lua Plug "williamboman/mason.nvim", { 'branch': 'alpha' } Plug "williamboman/mason-lspconfig.nvim" Plug "neovim/nvim-lspconfig" ```

docs: update mason-lspconfig.setup_handlers() docs & add some tests (#94)

2022-07-17T21:18:24Z

docs: add reference link to help (#85)

2022-07-16T14:55:15Z

feat(mason-lspconfig): add get_installed_servers() method & add more tests (#84)

2022-07-16T14:46:23Z

docs: updates (#83)

2022-07-16T14:27:56Z

docs: update mason-lspconfig (#79)

2022-07-15T17:50:58Z

docs: update reference.md (#78)

2022-07-15T13:35:41Z

docs: add doc/reference.md for more advanced use cases (#75)

2022-07-15T00:06:38Z

docs: add docs for mason-lspconfig (#61)

2022-07-12T21:40:37Z

feat(api): run :MasonInstall in blocking fashion if no UIs are attached (#52)

2022-07-11T15:08:05Z

Also make sure to exit neovim with an error exit code should one or more installations fail.

chore: adjust some remnants of nvim-lsp-installer

2022-07-06T23:02:13Z

mason.nvim

2022-07-06T22:39:59Z

chore: update some logging (#761)

2022-06-07T23:36:47Z

* chore: update some logging * docs: add section about known errors

docs: introduce separate requirements section (#758)

2022-06-07T11:47:35Z

docs: remove nvim-lsp-installer.servers helptag (#755)

2022-06-05T22:43:08Z

All interactions from userland should preferably go through require("nvim-lsp-installer").

feat(ui): add setting to customize window border (#754)

2022-06-05T22:28:58Z

Closes #752.

docs: update plugin intro

2022-06-01T11:55:29Z

docs: remove custom servers docs

2022-05-31T11:16:52Z

The ability to register custom servers still exist, it's just not documented anymore. This will be reintroduced in some shape or form in the future.

feat: add teal_ls (#724)

2022-05-27T14:23:51Z

Closes #723.

feat: add setting to disable automatic version check when opening UI window (#716)

2022-05-23T16:03:13Z

feat(github): add setting to customize asset download url (#711)

2022-05-21T15:41:42Z

Closes #678.

docs: add comments mentioning ensure_installed has no relation with automatic_installation

2022-05-12T19:23:48Z

ensure_installed is used as a hard-coded list of servers to always install, no matter if they're setup or not. automatic_installation is used to automatically detect which servers needs to be installed, based on which servers are setup via lspconfig.

feat(hls): install via ghcup (#667)

2022-05-05T10:52:27Z

fix(docs): don't use helptags syntax for deprecation notices

2022-05-02T17:25:20Z

Fixes #658. Closes #660.

chore: bump minimum neovim version to 0.7.0 (#656)

2022-05-02T01:07:15Z

feat: allow excluding servers from automatic installation (#643)

2022-04-30T13:44:37Z

feat: add 'automatic_installation' feature toggle to setup options (#638)

2022-04-29T11:32:59Z

docs: more deprecations and update some outdated docs

2022-04-29T11:15:46Z

feat: add ensure_installed to setup table (#637)

2022-04-28T15:14:21Z

docs: remove Rust Wiki link

2022-04-28T14:12:00Z

With the new setup structure, this is no longer relevant.

feat: integrate with lspconfig's on_setup hook (#631)

2022-04-27T19:20:45Z

* feat: integrate with lspconfig's on_setup hook * fix!: don't use aliased installation directories if new .setup() fn is used This makes it so servers are always installed in a directory name that corresponds with the server name. The reason aliased installation directories is supported is lost on me, but it's legacy and complicates things unnecessarily. This is a breaking change for users who previously were using the `.on_server_ready()` hook, and now transitioned to setting up servers directly via lspconfig. These users will need to reinstall the server. * fix: block usage of the deprecated server:setup() method if new setup method is used * fix: allow passing no arg to setup() * docs: ok final.v3 readme

add cargo to healthcheck

2022-04-18T13:04:31Z

docs: add missing footnote to Usage section

2022-03-14T11:50:24Z

doc: change wording in intro

2022-02-14T17:10:02Z

docs: remove "advanced" example snippet

2022-02-12T22:48:09Z

There wasn't much thought put into this snippet, it was just added as an example of what one could do. The snippet happens to demonstrate how to automatically install servers - this is however already documented (in a different fashion) in the Wiki.

doc: slight improvements

2022-02-06T20:48:30Z

update README

2022-01-23T16:17:31Z

leverage PATH for locating local executables (#283)

2022-01-02T16:54:56Z

1. This is a breaking change for the following servers, which will have to be reinstalled: - ltex - clangd 2. This is a breaking change for users who reach into the default options (for example via server:get_default_options()) to access the `cmd` property. nvim-lsp-installer no longer provides the `cmd` (except in a few instances), but instead provides an amended PATH which allows neovim's LSP client to locate the locally installed executable. To access the `cmd`, simply access it via lspconfig instead, for example like so: local default_config = require("lspconfig.server_configurations.rust_analyzer").default_config print("I can now access the cmd governed by lspconfig:", default_config.cmd) 3. This is a breaking change for 3rd party use cases that makes use of the `executable()` APIs (e.g., `npm.executable(root_dir, "tsserver")`). The recommended usage is to instead to use the canonical name of the command ("tsserver"), while providing an amended PATH, for example: local npm = require("nvim-lsp-installer.installers.npm") local server = server.Server:new { ..., root_dir = root_dir, installer = npm.packages { "tsserver" }, default_options = { cmd = { "tsserver" }, cmd_env = npm.env(root_dir), } }

feat(ui): add keybind to update all installed servers (#353)

2021-12-23T18:05:49Z

feat: allow server installation by just typing `:LspInstall` (#331)

2021-12-13T06:54:47Z

This will prompt the user which server associated with the currently opened buffer's &filetype to install.

docs: clarify how servers are installed and the recommended setup (#306)

2021-12-04T18:55:07Z

server: add {version} param to server:install()

2021-11-17T15:15:48Z

doc: update nvim-lspconfig links

2021-11-11T13:34:41Z

docs: wrap table arg with parantheses to avoid ambiguous syntax

2021-11-08T14:36:23Z

fix: add server setup example (#192)

2021-11-03T13:11:10Z

Co-authored-by: William Boman

server: add attach_buffers() method (#220)

2021-10-31T11:05:44Z

server: add :on_ready() method (#214)

2021-10-30T14:26:00Z

doc: add some docs

2021-10-29T17:31:01Z

breaking change: remove federated server mechanism (#207)

2021-10-29T14:08:21Z

Users will have to reinstall the following servers: - cssls - html - jsonls

add synchronous variants of commands for better headless interop (#189)

2021-10-26T07:47:20Z