About

mise (pronounced “meez”), short for mise-en-place, helps you set up and work in development environments. The name comes from the French culinary practice of preparing ingredients and utensils before cooking. In a project, mise.toml serves a similar purpose: it records the tools, environment, and commands needed to get to work.

What mise manages

• Development tools: install runtimes and command-line tools, select versions per project, and share those choices with your team and CI.
• Environment variables: define project configuration, load dotenv files or secrets, and activate environments such as Python virtualenvs.
• Tasks: give build, test, lint, and other commands names, dependencies, and arguments.
• Machine setup: declare packages, files, services, and other host setup separately from a project's tool installations.

You can adopt these features independently. Start by managing one tool or one task; you do not need to move all your existing scripts and configuration at once.

Where to start

Follow Getting Started for the first setup, then the walkthrough to work through a project. The glossary explains terms such as backend, shim, and task. Use Troubleshooting when a command or shell environment does not behave as expected.

Contact

mise was created by Jeff Dickey and is developed with its contributors. The aim is to make development easier and more consistent across languages. Questions, bug reports, and suggestions are welcome; see Contact for the right place to start.