Livt for Visual Studio Code

Build, test, and maintain Livt hardware projects without leaving VS Code. The extension combines Livt language intelligence, project and package workflows, Test Explorer integration, guided tool installation, and a Livt-aware agent.

Highlights

Edit .lvt files with syntax highlighting, snippets, completion, hover information, diagnostics, navigation, formatting, semantic highlighting, document symbols, code actions, and configurable inlay hints.
Explore sources, tests, generated output, dependencies, and the project outline from the dedicated Livt activity-bar view.
Build, test, validate, clean, format, synchronize, lock, vendor, and publish Livt projects from commands, views, or VS Code tasks.
Run and rerun Livt tests from VS Code's Testing view, with failures linked back to their source locations.
Search for packages, inspect package details, and manage project dependencies from the Livt Packages view.
Install and update Java, Livt, HxS, and optional GHDL through a guided setup experience.
Use Livt Agent for Livt-aware questions, planning, project changes, builds, tests, dependency work, and repairs.

The Livt language server is bundled with the extension. A persistent compiler worker keeps repeated project operations responsive and provides progress, cancellation, recovery, and diagnostics for longer-running work.

Getting Started

Install the extension and run Livt: Manage Livt Installation.
Sign in when prompted, then install Java, Livt/HxS, and optionally GHDL.
Open a folder containing livt.toml, or run Livt: Initialize Project.
Add files with Livt: Create Component or Livt: Create Test.
Run tests from the Testing view and build from the Livt Project view.

Open the Command Palette and run Livt: Open Getting Started Walkthrough. You can also find the walkthrough on the Welcome page under Walkthroughs. Language and installation documentation is available at https://docs.eccelerators.com.

Requirements

VS Code 1.100.2 or newer.
OpenJDK 17 or newer for the bundled language server. The extension can install a user-local runtime for you.
The Livt CLI on PATH, installed through the extension, or configured with livt.path.
GHDL when using the default fast-feedback simulator. GHDL is optional when using a supported vendor simulator instead.

Livt Agent and Chat Tools

Open Livt Agent from the secondary sidebar to work with an assistant that understands Livt projects and workflows. It can inspect relevant project context, propose reviewable file changes, run Livt operations, and use current diagnostics and command results to verify its work.

You control which project files the agent may access through the Agent Context view. If more context is needed, the agent asks for access before it continues. Proposed file changes can be kept or discarded.

The extension also contributes Livt tools to compatible VS Code chat agents. These cover validation, build, test, clean, dependency management, package search, vendor generation, and publishing. Tool availability and approval behavior can be managed through the VS Code tools UI.

Account and Installation

Sign in to Eccelerators from VS Code to manage your account, install or update Livt and HxS, optionally install managed Java and GHDL, and synchronize licenses. Managed third-party tools are stored in versioned directories under .livt/tools.

After installation, the Livt language tools can be used without remaining signed in. Livt Agent access is authorized by the installed Livt license.

Configuration

The most commonly used settings are:

Setting	Purpose
`livt.path`	Path to the Livt CLI executable.
`livt.java.home` / `livt.java.path`	Java runtime used by the language server.
`livt.ghdl.path`	GHDL executable used by Livt's default simulator.
`livt.languageServer.enabled`	Enables or disables the Livt language server.
`livt.languageServer.trace`	Controls language-server protocol tracing.
`livt.languageServer.jvmArgs`	Adds JVM arguments for the language server.
`livt.formatting.*`	Controls formatting and formatter options.
`livt.inlayHints.*`	Controls inlay hints and their level of detail.

All available settings include descriptions in VS Code's Settings editor. Open Settings and search for Livt.

Troubleshooting

Run Livt: Show Extension Diagnostics and inspect the Livt output channels.
If a tool cannot be found, use Livt: Manage Livt Installation or configure livt.path, livt.java.home, livt.java.path, or livt.ghdl.path.
After changing or updating a Livt installation, run Livt: Restart Compiler if compiler commands stop responding.
After correcting a language-server configuration problem, run Livt: Restart Language Server.
To reduce formatting while editing, disable livt.formatting.enabled.

Known Limitations

Generated outputs are discovered from the configured outdir; stale artifacts are shown only when they can be identified from local files.
Vendor-specific generation depends on Livt CLI support and the corresponding vendor tools being installed.

Release Notes

See the Changelog tab for release details.

Livt

Eccelerators