Livt for Visual Studio Code
Livt for VS Code brings the core Livt edit, test, build, and package workflow into the editor.
Features
.lvt language registration, syntax highlighting, snippets, bracket rules, and word patterns.- Bundled Livt language server for hover, completion, diagnostics, document symbols, semantic tokens, inlay hints, formatting, code actions, and navigation.
- Livt Project and Dependency views for source files, tests, generated outputs, package state, and common project actions.
- Test Explorer integration with source-linked failures and rerun support.
- VS Code tasks and command-palette actions for build, test, clean, sync, lock, validate, stats, vendor generation, and package publishing.
- VS Code Language Model tools for Copilot Chat and Agent mode through
#livt-* references.
- First-run walkthrough for checking the installation and learning the project workflow.
Requirements
- VS Code 1.100.2 or newer.
- OpenJDK 17 or newer for the bundled language server.
- The Livt CLI available on
PATH, or configured through livt.path.
Install Livt using the official installation guide: https://eccelerators.com/Installation.
Getting Started
- Run Livt: Show Extension Diagnostics to verify Java, the Livt CLI, and the bundled language server.
- Open a folder with
livt.toml, or run Livt: Initialize Project.
- Use Livt: Create Component or Livt: Create Test to add files.
- Run tests from the Testing view or Livt: Test Livt Project.
- Run Livt: Build Livt Project, then inspect generated output in the Livt Project view.
Language documentation starts at https://eccelerators.com/LivtIntroduction.
Configuration
| Setting |
Purpose |
livt.path |
Path to the Livt CLI executable. |
livt.java.home / livt.java.path |
Java runtime used to start the language server. |
livt.languageServer.enabled |
Enables or disables language-server startup. |
livt.languageServer.trace |
Controls JSON-RPC tracing. |
livt.languageServer.jvmArgs |
Additional JVM arguments for the language server. |
livt.formatting.* |
Formatting enablement and formatter options. |
livt.inlayHints.* |
Inlay hint enablement and detail controls. |
livt.debugServer.* |
Connect to an externally running debug language server. |
The extension contributes Livt tools for Copilot Chat and Agent mode, including version checks, build, test, clean, dependency management, package search, vendor generation, and publish workflows. Tools can be enabled or disabled from the VS Code tools UI, and native confirmation dialogs appear before commands execute.
Troubleshooting
- Run Livt: Show Extension Diagnostics and inspect the Livt output channels.
- If Java is not found, set
livt.java.home or livt.java.path.
- If the CLI is not found, set
livt.path.
- If formatting is noisy while editing, set
livt.formatting.enabled to false.
- If language-server startup fails, run Livt: Restart Language Server after fixing configuration.
Known Limitations
- The extension consumes the bundled
resources/livt-lsp.jar; update it from the sibling livt-lsp build before packaging a release.
- Generated outputs are discovered from the configured
outdir; stale artifacts are shown only when they can be determined from local files.
- Vendor-specific generation depends on Livt CLI support and installed vendor tooling.
Release Notes
See CHANGELOG.md and RELEASE_CHECKLIST.md.
| |
