Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/SemanticWebLanguageServer/swls-vscode/llms.txt

Use this file to discover all available pages before exploring further.

SWLS can be installed in VS Code directly from the Visual Studio Marketplace or Open VSX Registry, and works on desktop and in browser-based VS Code environments. A separate NeoVim plugin is also available for users who prefer that editor. No configuration is required to get started — the extension activates automatically when you open a supported file.

Installing in VS Code

SWLS requires VS Code >=1.100.0.
1

Find the extension

Open the Extensions panel (Ctrl+Shift+X / Cmd+Shift+X) and search for “Semantic Web LSP”, or open the Marketplace page directly:
2

Install the extension

Click Install. VS Code will download and install the extension automatically.
3

Open a Turtle file

Open any .ttl file — the extension activates automatically for Turtle, TriG, and JSON-LD files. You will see the swls output channel become active in the Output panel.

Startup behavior

When the extension activates it determines the best available server implementation:
  1. swls.command setting — If swls.command is set to a non-empty path in your VS Code settings, SWLS uses that binary directly.
  2. Bundled binary — Otherwise, SWLS looks for an swls (or swls.exe on Windows) binary inside its own extension directory. If found, it is launched as a child process over stdio.
  3. WASM fallback — If neither of the above produces a binary, the extension loads a bundled WASM build of the language server inside a Node.js worker_threads Worker. All LSP features are available immediately; there is no need to wait for a binary download.
You can set "swls.command": "/usr/local/bin/swls" in your VS Code settings to point SWLS at a binary you have built or installed manually, instead of the one bundled in the extension directory.

Automatic update checks

On startup, SWLS queries the GitHub Releases API for the SemanticWebLanguageServer/swls repository. If a newer release is available you will be prompted with an Install or Update button. After the download completes you will be asked to reload the window; the reload switches from the WASM fallback to the newly installed native binary.
Update checks require network access to api.github.com. If you are in an air-gapped environment, set "swls.checkUpdate": false to suppress the check. See the Updates guide for full details on controlling update behaviour.
SettingDefaultDescription
swls.checkUpdatetrueCheck GitHub for new releases on startup
swls.automaticUpdatefalseInstall updates without prompting
swls.command""Path to a custom swls binary

Build docs developers (and LLMs) love