Skip to main content
Back to Extensions Directory
coc.nvim fallback icon

coc-luals

xiyaowong

Lua extension using lua-language-server for coc.nvim

Installation CommandVim prompt
:CocInstall coc-luals
GitHub owner
xiyaowong
Version
v1.2.1
npm package
coc-luals
Requirements
coc ^0.0.80
License
MIT
Repository
GitHub
npm latest published 2026-10-16Node >=22.0.0Registry summary

Published Package Summary

🌙 coc-luals

Lua Language Server extension for coc.nvim
Full LuaLS feature support with tailored Neovim Lua integration

Version License LuaLS


coc-luals is a coc.nvim extension powered by lua-language-server (LuaLS). It provides the full feature set of LuaLS/vscode-lua, along with dedicated Neovim Lua development utilities like dynamic library imports and integrated addon management.


✨ Features

  • 🎯 Full LuaLS Support: Complete language server features and configuration schema, using official binaries extracted from LuaLS/vscode-lua.
  • ⚡ Auto-Download: Automatically downloads prebuilt binaries on first launch (Windows, macOS, Linux), or point to your own binary.
  • 🧩 Neovim Lua Development: Auto $VIMRUNTIME loading, on-demand plugin library imports on require('...'), and quickfix code actions.
  • 📦 Addon Manager: Browse, install, and toggle official LuaLS/LLS-Addons directly in coc.nvim via :CocList lls_addons.

📦 Installation

Install via coc.nvim:

:CocInstall coc-luals

💡 On first launch, if lua-language-server is not found, coc-luals prompts to download the prebuilt binary automatically.


📖 Neovim Lua Development

Designed for editing Neovim configurations and plugins:

  • Automatic $VIMRUNTIME: Provides autocompletion and documentation for Neovim runtime APIs (vim.api.*, vim.fn.*, etc.).
  • Runtime Plugin Completion: Autocomplete suggestions include modules from installed runtime plugins.
  • Dynamic Library Import: Instead of adding every installed plugin to workspace.library at startup, definitions are loaded on-the-fly when used.
  • Code Action: Offers Import library '<name>' to workspace on unimported module calls.

🧩 Addon Manager

Manage addons from LuaLS/LLS-Addons (e.g. definitions and annotations for Busted, LÖVE, OpenResty, Hammerspoon).

Open the addon list:

:CocList lls_addons
" or
:CocCommand lua.openAddonManager

Status Indicators

IndicatorStatus
[+]Enabled in workspace
[*]Installed (disabled)
[-]Available (not installed)

Actions

  • <CR>: Enable addon (downloads and installs automatically if not yet present).
  • <Tab>: Open action menu:
    • enable: Enable addon and apply workspace settings
    • disable: Disable addon and revert settings
    • install: Download and cache addon
    • uninstall: Remove local addon cache
    • view on github: Open repository in browser

🛠️ Server Executable

  • Default: Uses official release binaries extracted from LuaLS/vscode-lua.
  • Custom Executable / Directory: To use a system package or custom build:
    {
      "Lua.misc.executablePath": "lua-language-server"
      // or
      // "luals.serverDir": "/path/to/lua-language-server"
    }
    

📄 License

MIT © wongxy

Read the complete README
  • Lua extension using lua-language-server for coc.nvim
Activation Events
  • onLanguage:lua
Developer Resources

Want to build, test, or contribute to coc.nvim extensions? Explore our official SDK and testing toolkits.

Open Developer Guide

Version History

Published with coc-luals@1.2.1 as CHANGELOG.md.

Open source file

Changelog

1.2.1 (2026-10-16)

Bug Fixes

  • include missing files in published package (c0b9905)

1.2.0 (2026-10-16)

Features

  • addon: support multiple selections (b55837e)

Schema