⚡︎ BoxLang Module: bx-lsp

This is a BoxLang module that implements Microsoft's Language Server Protocol. You most likely will not want to install this module directly. This modules is used by IDE's that also implement the LSP in order to provide a rich editing experience.

Check out the official BoxLang VSCode extension for more information and an example of this project being used.

Ortus Sponsors

BoxLang is a professional open-source project and it is completely funded by the community and Ortus Solutions, Corp. Ortus Patreons get many benefits like a cfcasts account, a FORGEBOX Pro account and so much more. If you are interested in becoming a sponsor, please visit our patronage page: https://patreon.com/ortussolutions

Configuration

The BoxLang LSP is controlled through three separate configuration systems:

System	File	Purpose
IDE Workspace Settings	`boxlang.lsp.*` in your IDE settings	LSP behavior & performance
Project Mappings	`boxlang.json` at workspace root	Virtual paths, classpaths, module directories
Lint Rules	`.bxlint.json` at workspace root	Static analysis rule toggles and severity

See the Configuration Reference for the complete list of all settings, types, defaults, and descriptions.

Live Reload Behavior

The server watches .bxlint.json using both LSP file events (if supported) and a fallback filesystem watcher.
On change: cache invalidated → config reloaded → open documents reparsed → diagnostics republished.
Watcher debounce is minimal; rapid saves may still trigger multiple reloads (acceptable for now).

Troubleshooting

Symptom	Possible Cause	Action
Config edits ignored	File not at workspace root	Move `.bxlint.json` to root folder recognized by client
Rules not disabling	Rule id typo	Check the rule ID in the Configuration Reference
Paths not filtered	Globs mismatched OS separators	Always use forward slashes `/`

THE DAILY BREAD

"I am the way, and the truth, and the life; no one comes to the Father, but by me (JESUS)" Jn 14:1-12

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

1.9.0 - 2026-04-02

BLIDIE-277 Improve LSP setting documentation
BLIDE-272 Prevent duplicate diagnostics in editor
BLIDE-271 Improve interface method diagnostics
Improve project indexing
Add API for querying the project index
BLIDE-224 Add hover support for variables, functions, classes, and interfaces
BLIDE-215 Add go-to-definition for variables, functions, classes, and interfaces
BLIDE-236 Add find references for variables, functions, classes, and interfaces
BLIDE-224 Add variable type insights
BLIDE-213 Add context aware auto complete for keywords, references, arguments, and imports
BLIDE-213 Add snippet completions
BLIDE-270 Add auto import support on save
BLIDE-215 Add ability to go to definition of BoxLang functions within the same file
BLIDE-236 Add ability to find references of a BoxLang function within the same file