Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/hverlin/mise-vscode

VSCode extension for mise-en-place (https://mise.jdx.dev/)
https://github.com/hverlin/mise-vscode

asdf developer-tools extension mise mise-en-place vscode vscode-extension

Last synced: 13 days ago
JSON representation

VSCode extension for mise-en-place (https://mise.jdx.dev/)

Host: GitHub
URL: https://github.com/hverlin/mise-vscode
Owner: hverlin
License: mit
Created: 2024-11-11T00:12:18.000Z (3 months ago)
Default Branch: main
Last Pushed: 2025-01-14T20:56:39.000Z (19 days ago)
Last Synced: 2025-01-14T21:21:25.937Z (19 days ago)
Topics: asdf, developer-tools, extension, mise, mise-en-place, vscode, vscode-extension
Language: TypeScript
Homepage: https://marketplace.visualstudio.com/items?itemName=hverlin.mise-vscode
Size: 3.57 MB
Stars: 26
Watchers: 3
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # mise-vscode 🛠️

[![VS Code Marketplace](https://img.shields.io/visual-studio-marketplace/v/hverlin.mise-vscode)](https://marketplace.visualstudio.com/items?itemName=hverlin.mise-vscode)

[![Open VSX](https://img.shields.io/open-vsx/v/hverlin/mise-vscode)](https://open-vsx.org/extension/hverlin/mise-vscode)

[![Documentation](https://img.shields.io/badge/wiki-Documentation-blue)](https://hverlin.github.io/mise-vscode/)

Visual Studio Code extension for [mise](https://mise.jdx.dev/) (`mise-en-place`).

> [mise](https://mise.jdx.dev/) is a polyglot tool version manager, environment

> variables manager, and tasks runner.

>

> - Like asdf (or nvm or pyenv but for any language), it manages dev tools like

>   node, python, cmake, terraform, and hundreds more.

> - Like direnv, it manages environment variables for different project

>   directories.

> - Like make, it manages tasks used to build and test projects.

This VSCode extension provides an easy way to manage `mise`

[tasks](https://hverlin.github.io/mise-vscode/reference/tasks/),

[tools](https://hverlin.github.io/mise-vscode/reference/tools/), and

[environment variables](https://hverlin.github.io/mise-vscode/reference/environment-variables/)

directly from your editor.

It can automatically

[configure other extensions](https://hverlin.github.io/mise-vscode/reference/supported-extensions/)

to use tools provided by `mise` in your current project.

[![mise-vscode screenshot](screenshots/mise-vscode-screenshot.png)](https://hverlin.github.io/mise-vscode/)

## Installation

- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=hverlin.mise-vscode)

- [Open VSX Registry](https://open-vsx.org/extension/hverlin/mise-vscode)

> [!NOTE]

> The extension includes default settings that you might want to change. See the [configuration guide](https://hverlin.github.io/mise-vscode/tutorials/settinguptheextension/) to customize your setup.

## ✨ Features

The mise-vscode extension integrates mise's core functionality into VS Code, helping you manage your development environment directly from the editor. You can handle task running, tool versions, and environment variables through a simple interface. Here's what's available:

### [mise.toml Language Support](https://hverlin.github.io/mise-vscode/reference/misetoml-language-support/)

- 📝 Syntax highlighting for `mise.toml` files (and [tera templates](https://mise.jdx.dev/templates.html))

- 📚 Autocompletion for `mise.toml` files

- 🔗 Go to definition, find references for mise tasks

### [Task Management](https://hverlin.github.io/mise-vscode/reference/tasks/)

- 🔍 Automatic detection of [mise tasks](https://mise.jdx.dev/tasks/)

- ⚡ Run tasks directly from, `mise.toml` files, file tasks, the command palette

  or the activity bar (arguments are supported)

- 📝 View task definitions

- ➕ Create new toml & file tasks

- ⚡ Autocompletion of task dependencies

- 🕸️ View graph of task dependencies

### [Tool Management](https://hverlin.github.io/mise-vscode/reference/tools/)

- 🧰 View all [mise tools](https://mise.jdx.dev/dev-tools/) (python, node, jq,

  etc.) in the sidebar

- 📍 Quick navigation to tool definitions

- 📱 Show tools which are not installed or active

- 📦 Install/Remove/Use tools directly from the sidebar

- 🔧 Configure your other VSCode extensions to use tools provided by `mise`

  ([list of supported extensions](https://hverlin.github.io/mise-vscode/reference/supported-extensions/))

### [Environment Variables](https://hverlin.github.io/mise-vscode/reference/environment-variables/)

- ⚙️ View [mise environment variables](https://mise.jdx.dev/environments/)

- 📍 Quick navigation to environment variable definitions

- 🔄 Automatically load environment variables from `mise.toml` files in VS Code

### Snippets

- 📝 Snippets to create tasks in `mise.toml` and task files

### Integration with VSCode tasks (`launch.json`)

This extension lets

[VSCode tasks](https://code.visualstudio.com/docs/editor/tasks) use `mise`

tasks. You can use `mise` tasks in your `launch.json` file.

See the

[VSCode task integration docs section](https://hverlin.github.io/mise-vscode/reference/tasks/#vscode-task-integration)

for more information.

## [Documentation](https://hverlin.github.io/mise-vscode/)

- [Getting Started](https://hverlin.github.io/mise-vscode/tutorials/getting-started/)

- [Important Defaults](https://hverlin.github.io/mise-vscode/tutorials/settinguptheextension/)

- [FAQ](https://hverlin.github.io/mise-vscode/explanations/faq/)

### Reference

- [Tools](https://hverlin.github.io/mise-vscode/reference/tools/)

- [Environment variables](https://hverlin.github.io/mise-vscode/reference/environment-variables/)

- [Tasks](https://hverlin.github.io/mise-vscode/reference/tasks/)

- [mise.toml language support](https://hverlin.github.io/mise-vscode/reference/misetoml-language-support/)

- [Supported extensions](https://hverlin.github.io/mise-vscode/reference/supported-extensions/)

- [Extension Settings](https://hverlin.github.io/mise-vscode/reference/settings/)

### Guides

Setup for [Bun](https://hverlin.github.io/mise-vscode/guides/bun/), [Deno](https://hverlin.github.io/mise-vscode/guides/deno/), [Flutter](https://hverlin.github.io/mise-vscode/guides/flutter/), [Go](https://hverlin.github.io/mise-vscode/guides/golang/), [Java](https://hverlin.github.io/mise-vscode/guides/java/), [Julia](https://hverlin.github.io/mise-vscode/guides/julia/), [Node.JS](https://hverlin.github.io/mise-vscode/guides/node/), [PHP](https://hverlin.github.io/mise-vscode/guides/php/), [Python](https://hverlin.github.io/mise-vscode/guides/python/)

## Bug Reports / Feature Requests / Contributing

- Found a bug? Please

  [open an issue](https://github.com/hverlin/mise-vscode/issues)

- Contributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for more

  information.

Note that this extension is tested against the latest version of `mise`. If you

encounter an issue, make sure to update `mise` first with `mise self-update` or

using your package manager.

## Ecosystem

- See [intellij-mise](https://github.com/134130/intellij-mise) if you are

  looking for a similar plugin for IntelliJ IDEA

- [Mise documentation](https://mise.jdx.dev/)

## License

This extension is licensed under the MIT License. See the [LICENSE](LICENSE)

file for details.