mise-vscode 🧑🍳
Visual Studio Code extension for mise (mise-en-place) and pitchfork. 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.
pitchfork runs the daemons of a project, like a
database or a development server, which
mise can declare too.
This VSCode extension provides an easy way to manage mise
tasks,
tools,
environment variables,
and daemons
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.
Installation
This extension provides basic syntax highlighting for mise.toml/mise.lock files.
For the best experience with autocompletion and validation in mise.toml files, install the Tombi TOML extension.
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:
- 📝 Syntax highlighting for
mise.toml files (and tera templates)
- 📚 Autocompletion for
mise.toml files, and for the variables, functions,
filters and tests of tera templates
- 🧩 Autocompletion & hover for task arguments
(
usage field, #USAGE/#MISE comments in file tasks, $usage_* variables)
- 🔗 Go to definition, find references for mise tasks
- 🪄 Syntax highlighting for extensionless
tool stub files
- 🔍 Automatic detection of mise tasks
- ⚡ Run tasks directly from,
mise.toml files, file tasks, the command palette
or the activity bar (task arguments are prompted for, with choices and
default values from the usage spec)
- 📝 View task definitions
- ➕ Create new toml & file tasks
- ⚡ Autocompletion of task dependencies
- 🧬 Autocompletion, hover, go to definition and find references for
task templates (
extends)
- 🕸️ View graph of task dependencies
- 🧰 View all mise 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). See the set-up guide for more information.
- ⚙️ View mise environment variables
- 📍 Quick navigation to environment variable definitions
- 🔄 Automatically load environment variables from
mise.toml files in VS Code
- 🚦 View the mise daemons and
pitchfork daemons of the project, with their
status
- ▶️ Start/Stop/Restart them, follow their logs, open them in the browser
- ✍️ Completion, hover and go to definition for daemon names in
mise.toml
- 🔁 Optionally start and stop them with the workspace (
auto = ["start", "stop"])
- 🤖 Optionally provide the
mise mcp and pitchfork mcp servers to the AI
agents of VS Code
Snippets
- 📝
mise-task snippets to create tasks in mise.toml and task files, and
mise-daemon snippets to declare daemons in mise.toml. They are only
suggested in the files mise loads, and only where they can be inserted. Set
mise.enableSnippets to false to turn them off.
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.
Reference
Guides
Setup for Bun, Deno, Flutter, Go, Java, Julia, Node.JS, PHP, Python
Bug Reports / Feature Requests / Contributing
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
License
This extension is licensed under the MIT License. See the LICENSE
file for details.
