mise-vscode 🛠️

Visual Studio Code extension for mise (mise-en-place). Documentation

mise 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, tools, and environment variables directly from your editor.

It can automatically configure other extensions to use tools provided by mise in your current project, including support for custom extensions.

• VS Code Marketplace
• Open VSX Registry

• Tombi TOML
• Even Better TOML (works well but not actively maintained anymore)

Important Defaults

The extension includes default settings that you might want to change. See the configuration guide to customize your set-up.

For example, you can choose to enable/disable automatic configuration of other extensions or change the path to the mise binary.

You can access the settings by clicking on the mise extension indicator in the status bar.

Enabling/Disabling Auto-Configuration

By default, the extension will not automatically configure other VS Code extensions to use tools provided by mise in your current project.

To enable auto-configuration, set mise.configureExtensionsAutomatically to true. This will automatically configure other VS Code extensions to use tools provided by mise in your current project.

Important: By default, tools from your global mise configuration (~/.config/mise/config.toml) are included when auto-configuring other VS Code extensions (mise.configureExtensionsIncludeGlobalTools is true for backward compatibility). You can set it to false to keep your .vscode/settings.json clean and ensure extensions are only configured for tools actually used in your project.

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

• 📝 Syntax highlighting for mise.toml files (and tera templates)
• 📚 Autocompletion for mise.toml files
• 🧩 Autocompletion & hover for task arguments

• 🔗 Go to definition, find references for mise tasks
• 🪄 Syntax highlighting for extensionless

Task Management

• 🔍 Automatic detection of mise tasks
• ⚡ Run tasks directly from, mise.toml files, file tasks, the command palette

• 📝 View task definitions
• ➕ Create new toml & file tasks
• ⚡ Autocompletion of task dependencies
• 🧬 Autocompletion, hover, go to definition and find references for

• 🕸️ View graph of task dependencies

Tool Management

• 🧰 View all mise tools (python, node, jq,

• 📍 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

Environment Variables

• ⚙️ View mise environment variables
• 📍 Quick navigation to environment variable definitions
• 🔄 Automatically load environment variables from mise.toml files in VS Code

Snippets

• 📝 mise-task snippets to create tasks in mise.toml and task files. They

Integration with VSCode tasks (launch.json)

This extension lets VSCode tasks use mise tasks. You can use mise tasks in your launch.json file.

See the VSCode task integration docs section for more information.

Documentation

• Getting Started
• Important Defaults
• FAQ

Reference

• Tools
• Environment variables
• Tasks
• mise.toml language support
• Supported extensions
• Extension Settings

Guides

Bug Reports / Feature Requests / Contributing

• Found a bug? Please

• Contributions are welcome! See CONTRIBUTING.md for more

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 if you are

• Mise documentation

License

This extension is licensed under the MIT License. See the LICENSE file for details.