# Installation ### VSCode Marketplace * **Release Version: (**major.EVEN\_NUMBER.patch)\ Search for "BoxLang" in the Extensions view and click "Install". * **Pre-release Version: (**major.ODD\_NUMBER.patch)\ On the extension page, select "Switch to Pre-Release" to install the latest beta. We do our best to follow the official guidelines on pre-release development cycles for VSCode extensions. You can read about the recommended approach here \ The TLDR; of release/pre-release versioning is that as a user, you can select whichever version you would like to use. VSCode will do its best to always supply you with the latest version you have requested. For instance, if you prefer pre-release distributions it will always try to update you to the latest pre-release version.\ \ A version that includes an even number in the minor spot like `3.4.5` will be considered an official release. A version that includes an odd number in the minor spot like `2.7.2` will be considered a pre-release. ### OpenVSX Visit [OpenVSX](https://open-vsx.org/) and search for "BoxLang" or go directly to the official [BoxLang Extension listing](https://open-vsx.org/extension/ortus-solutions/vscode-boxlang).
There is a download button on the right-hand side of the page that will allow you to download/install the extension. Once downloaded you can install via CLI ``` code --install-extension /path/to/boxlang.vsix ``` Or you can install through the UI by opening VSCode > sidebar extension menu > dot menu > Install from VSIX... ### Manual Build & Install * Clone the repo: ``` git clone https://github.com/ortus-solutions/vscode-boxlang.git cd vscode-boxlang ``` * Install dependencies and build: ``` npm install npm run build ``` * Package and install: ``` npm run package code --install-extension boxlang-*.vsix ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://boxlang-ide.ortusbooks.com/vscode/installation.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.