mise-en-place

Run your first project task

1. Step 1

   Install mise

   On macOS or Linux, run the installer. It puts mise in ~/.local/bin; if that is not on your PATH, type ~/.local/bin/mise in the next two steps. On Windows, run winget install jdx.mise. See Installing mise for other methods.

   $ curl -fsSL https://mise.run | sh

   $ ~/.local/bin/mise --version
2. Step 2

   Try a tool

   mise exec installs Node.js 24 if needed and runs one command with it. Your shell and config files stay as they were.

   $ mise exec node@24 -- node --version

   v24.x.x
3. Step 3

   Set up a project

   These commands write [tools], [env], and [tasks.hello] to the project's mise.toml. The task runs with the project's Node.js and NODE_ENV. Commit mise.toml so teammates and CI get the same setup.

   $ mkdir my-project && cd my-project

   $ mise use node@24

   mise ~/my-project/mise.toml tools: node@24.x.x

   $ mise set NODE_ENV=development

   $ mise tasks add hello -- node -p process.env.NODE_ENV

   $ mise run hello

   [hello] $ node -p process.env.NODE_ENV

   development
4. Step 4 (optional)

   Activate mise in your shell

   Activation puts the project's tools and environment variables in your shell when you enter the project, so node works without mise exec. Run the commands for your shell once, then open a new shell. For PowerShell, Nushell, and others, see Shell setup.

   # bash

   $ echo 'eval "$(~/.local/bin/mise activate bash)"' >> ~/.bashrc

   # zsh

   $ echo 'eval "$(~/.local/bin/mise activate zsh)"' >> "${ZDOTDIR:-$HOME}/.zshrc"

   # fish

   $ mkdir -p ~/.config/fish

   $ echo '~/.local/bin/mise activate fish | source' >> ~/.config/fish/config.fish