{"id":18429061,"url":"https://github.com/openliberty/liberty-tools-vscode","last_synced_at":"2025-10-04T20:20:03.688Z","repository":{"id":40242898,"uuid":"204484936","full_name":"OpenLiberty/liberty-tools-vscode","owner":"OpenLiberty","description":"Visual Studio Code extension for Liberty Tools","archived":false,"fork":false,"pushed_at":"2025-08-06T14:02:05.000Z","size":13017,"stargazers_count":18,"open_issues_count":161,"forks_count":39,"subscribers_count":8,"default_branch":"main","last_synced_at":"2025-08-06T16:08:02.708Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://marketplace.visualstudio.com/items?itemName=Open-Liberty.liberty-dev-vscode-ext","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"epl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenLiberty.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-26T13:46:04.000Z","updated_at":"2025-08-06T14:02:10.000Z","dependencies_parsed_at":"2023-10-17T01:52:41.630Z","dependency_job_id":"9ab0861e-33e0-499c-8ff0-fb89e38fa12f","html_url":"https://github.com/OpenLiberty/liberty-tools-vscode","commit_stats":{"total_commits":315,"total_committers":23,"mean_commits":"13.695652173913043","dds":0.8222222222222222,"last_synced_commit":"f8cdd5c46389e1b780f9a8885dee453a88dac715"},"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/OpenLiberty/liberty-tools-vscode","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenLiberty%2Fliberty-tools-vscode","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenLiberty%2Fliberty-tools-vscode/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenLiberty%2Fliberty-tools-vscode/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenLiberty%2Fliberty-tools-vscode/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenLiberty","download_url":"https://codeload.github.com/OpenLiberty/liberty-tools-vscode/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenLiberty%2Fliberty-tools-vscode/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271444260,"owners_count":24760760,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-21T02:00:08.990Z","response_time":74,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-06T05:15:40.492Z","updated_at":"2025-10-04T20:19:58.637Z","avatar_url":"https://github.com/OpenLiberty.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Liberty Tools for Visual Studio Code\n\n\u003c!-- Match the VSCode and Java version in #requirements, and user-guide.md --\u003e\n\u003e Note: Requires **Visual Studio Code 1.78.0** or later, and **Java 17** or later.\n\u003e \n\u003e This page provides an overview of Liberty Tools for Visual Studio Code.\n\u003e For minimum requirements information and detailed instructions on how to use Liberty Tools, check the [user-guide](docs/user-guide.md).\n\n[![Marketplace Version](https://img.shields.io/visual-studio-marketplace/v/Open-Liberty.liberty-dev-vscode-ext?style=for-the-badge\u0026label=VS%20Market \"Current Release\")](https://marketplace.visualstudio.com/items?itemName=Open-Liberty.liberty-dev-vscode-ext)\n[![License](https://img.shields.io/github/license/OpenLiberty/liberty-tools-vscode?style=for-the-badge\u0026logo=eclipse)](https://www.eclipse.org/legal/epl-2.0/)\n\nLiberty Tools for Visual Studio Code offers features for developing cloud-native Java applications with [Open Liberty](https://openliberty.io/) and [WebSphere Liberty](https://www.ibm.com/products/websphere-liberty). Iterate fast with Liberty dev mode, code with assistance for MicroProfile \u0026 Jakarta EE APIs, and easily edit Liberty configuration files.\n\n![liberty dashboard screenshot](/docs/screenshots/liberty_dashboard.png)\n\n- [Features](#features)\n- [Quick start](#quick-start)\n- [Commands](#commands)\n- [Requirements](#requirements)\n- [Contributing](#contributing)\n- [Issues](#issues)\n\nUse Liberty Tools to run your Liberty Maven or Liberty Gradle projects through the Liberty dashboard or the VS Code command palette. You can start, stop, or interact with [Liberty dev mode](https://openliberty.io/docs/latest/development-mode.html) on all available [Liberty Maven](https://github.com/OpenLiberty/ci.maven/blob/master/docs/dev.md#dev) or [Liberty Gradle](https://github.com/OpenLiberty/ci.gradle/blob/master/docs/libertyDev.md) projects in your workspace. Liberty Tools also helps you quickly and easily edit your application and configuration files by providing language support features for MicroProfile, Jakarta EE, and Liberty configuration and Java files.\n\nFor minimum requirements information and detailed instructions on how to use Liberty tools, check out the [Liberty Tools for Visual Studio Code user guide](docs/user-guide.md) page.\n\n## Features\n\n- View supported Liberty projects in the Liberty dashboard.\n- Start/Stop dev mode.\n- Start dev mode with custom parameters.\n- Start dev mode in a container.\n- Attach the debugger.\n- Run tests.\n- View test reports.\n- Code with language assistance in the following configuration and application files:\n  - `server.xml`, `server.env`, `bootstrap.properties` Liberty configuration files\n  - Jakarta EE 9.x APIs in Java files\n  - MicroProfile APIs in `microprofile-config.properties` and Java files\n\nFeature completion in `bootstrap.properties` files helps you quickly edit your Liberty runtime configuration.\n\n![Liberty Config Language Server completion](/docs/screenshots/lcls_completion.png)\n\nHover in `server.xml` files provides more detailed descriptions.\n\n![Liberty Config Language Server hover](/docs/screenshots/lcls_hover.png)\n\nDiagnostics in `server.env` files helps you quickly spot errors in your Liberty runtime configuration.\n\n![Liberty Config Language Server diagnostic](/docs/screenshots/lcls_diagnostics.png)\n\nHelpful code snippets are provided in Java files for Jakarta EE APIs such as Jakarta RESTful Web Services.\n\n![Eclipse LSP4Jakarta completion](/docs/screenshots/lsp4jakarta_completion.png)\n\nEditing assistance for configuration and application files is provided through the following language server projects, which this project consumes. For more information, see the documentation for these projects.\n\n- Liberty configuration files: [Liberty Config Language Server](https://github.com/OpenLiberty/liberty-language-server#liberty-config-language-server)\n- Jakarta EE APIs in Java files:  [Eclipse LSP4Jakarta](https://github.com/eclipse/lsp4jakarta#eclipse-lsp4jakarta), the Language Server for Jakarta EE.\n\nLiberty Tools for Visual Studio Code depends on the [Tools for MicroProfile](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-microprofile) Visual Studio Code extension. This extension provides editing assistance for MicroProfile APIs in Java and `microprofile-config.properties` files.\n\n## Quick start\n\n- Install [Liberty Tools for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=Open-Liberty.liberty-dev-vscode-ext)\n- Select a project in the Liberty dashboard to view the available commands.\n\nProjects with the Liberty Maven Plugin or Liberty Gradle Plugin configured will appear in the Liberty Dashboard on the sidebar.\n\nFor minimum requirements information and detailed instructions on how to use the Liberty commands, check out the [Liberty Tools for Visual Studio Code user guide](docs/user-guide.md) page.\n\n## Commands\n\nThe following commands are available when you select a project in the Liberty Dashboard.\n\n| Command | Description |\n| --- | --- |\n| Start  | Start dev mode. |\n| Start…​ | Start dev mode with custom parameters. Supported parameters can be found in the documentation for the [dev goal of the Liberty Maven Plugin](https://github.com/OpenLiberty/ci.maven/blob/master/docs/dev.md#dev) and the [libertyDev task of the Liberty Gradle Plugin](https://github.com/OpenLiberty/ci.gradle/blob/master/docs/libertyDev.md#command-line-parameters). |\n| Start in a container | Start dev mode with Liberty running in a container. The `liberty-maven-plugin` must be version `3.3-M1` or higher. The `liberty-gradle-plugin` must be version `3.1-M1` or higher. |\n| Stop | Stop dev mode. Liberty must be running in dev mode to use this command. |\n| Run tests | Run the unit tests and integration tests that are configured for your project. Liberty must be running in dev mode to use this command. |\n| View integration test report (Maven) | View the integration test report file, if it exists at the  `/target/site/failsafe-report.html` default location.  |\n| View unit test report (Maven) | View the unit test report file, if it exists at the `/target/site/surefire-report.html` default location. |\n| View test report (Gradle) | Open the test report file, if it exists at the `build/reports/tests/test/index.html` default location. This action command is available only to Gradle projects. Gradle projects have only a single action command for test result reporting. |\n\n## Requirements\n\n\u003c!-- Match the VSCode and Java version on top of README.md, and user-guide.md  --\u003e\n**Visual Studio Code 1.78.0** or later, and **Java 17** or later.\n\nLiberty Tools for Visual Studio Code will check the `xml.java.home` VS Code setting or the `JAVA_HOME` system environment variable to ensure the LemMinX language server uses Java 17 or later. For further information on configuring your Java runtime for language servers, consult this [user guide section](/docs/user-guide.md#configure-your-java-runtime-for-language-servers).\n\nThe following extensions are bundled with Liberty Tools for Visual Studio Code during installation and are provided here for additional information.\n\n- [Tools for MicroProfile extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-microprofile)\n- [XML extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=redhat.vscode-xml)\n\n## Contributing\n\nSee the [DEVELOPING](DEVELOPING.md) and [CONTRIBUTING](CONTRIBUTING.md) documents for more details.\n\n## Issues\n\nPlease report bugs, issues and feature requests by creating\na [GitHub issue](https://github.com/OpenLiberty/liberty-tools-vscode/issues).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenliberty%2Fliberty-tools-vscode","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopenliberty%2Fliberty-tools-vscode","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopenliberty%2Fliberty-tools-vscode/lists"}