mise/Docs/Guides/Getting Started

• Getting Started | mise-en-place

  • #Install

    • basic steps

      • install mise with one of the following

        • shell script
          • curl https://mise.run | sh
        • #brew (not recommended)
          • brew install mise
          • My Note 2025-05-10 Sat - I ended up moving away from using brew to instal mise, because mise/self-update doesn't support brew installation. I may move away from this in the future if using brew to update mise seems like a more systematic way to manage the mise version.

      • add eval "$(~/.local/bin/mise activate zsh)" to zsh/.zshrc

        • You may need to run mise/doctor to verify the setup correctly.
          • if it states that you are out of date, you may need to run mise/self-update to update.

      • configure mise to use latest LTS version of NodeJS

        • mise use --global node@lts
        • My Notes
          • 2025-05-15 Thu You may also want to do mise use --global npm@11 or whatever is "lts"-ish

      • run mise/install and then resource the zsh/.zshrc to run mise/activate, then test node version

        • $> mise install
          gpg: Signature made Wed Apr 23 03:25:11 2025 EDT
          gpg:                using RSA key A6023530FC53461FEC91F99C04CD3F2FDE079578
          gpg: Good signature from "ulises Gascon <ulisesgascongonzalez@gmail.com>" [unknown]
          mise node@22.15.0 ✓ installed 
          
          $> node -v
          zsh: command not found: node
          
          $> . ~/.zshrc
          
          $> node -v
          v22.15.0

  • exec and run

    • mise can be used to install and run tools, launch tasks, and manage environment variables.

    • $ mise exec python@3 -- python
      mise hint use multiple versions simultaneously with mise use python@3.12 python@3.11
      mise hint installing precompiled python from astral-sh/python-build-standalone
      if you experience issues with this python (e.g.: running poetry), switch to python-build by running mise settings python.compile=1
      mise python@3.13.2 ✓ installed                                                                                                                                                 mise WARN  missing: node@18.20.7
      Python 3.13.2 (main, Feb 12 2025, 14:59:08) [Clang 19.1.6 ] on darwin
      Type "help", "copyright", "credits" or "license" for more information.
      >>> exit()
      
      $ mise exec node@22 -- node -v
      v22.14.0

    • mise x|exec is a powerful way to load the current mise context (tools & environment variables) without modifying your shell session or running ad-hoc commands with mise tools set. Installing tools is as simple as running mise use|u.

    • set a global default in the mise config

      • here we set the global NodeJS version used by default in mise to be the latest LTS version - mise use --global node@lts
        • My Note
          • 2025-05-10 Sat you want need to install gnupg with brew/install/gnupg so that it can verify the signature of the downloaded nodejs version

      • $ mise use --global node@lts
        mise ~/.config/mise/config.toml tools: node@22.14.0
        mise exec -- node my-script.js
        # run my-script.js with node 22...

    • mise/run

      • Another useful command is mise r|run which allows you to run a mise task or a script with the mise context.
      • #Tip
        • You can set a shell alias in your shell's rc file like alias x="mise x --" to save some keystrokes.

  • Activate mise

    • #Zsh - echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
      • #note - I got mise WARN missing: python@3.12.1 the first time, then I did RUST_BACKTRACE=1 mise exec python@3.12.1 -- python and it worked thereafter