1.1 ¿Por qué utilizar un gestor de herramientas?

Un desarrollador de software es habitual que trabaje en distintos proyectos, y cada uno de ellos hará uso de distintas herramientas y en versiones distintas. Una aplicación antigua podría depender de una versión concreta de Node.js mientras que un proyecto nuevo, por ejemplo desarrollado con Vue.js, puede requerir una versión más reciente. Instalar y cambiar manualmente estas versiones puede provocar conflictos y dificultar la configuración del equipo de desarrollo.

Un gestor como Mise permite asociar las herramientas y versiones necesarias al propio proyecto. Esto facilita que todos los desarrolladores trabajen con un entorno idéntico y reduce los problemas causados por utilizar versiones diferentes de Node.js, npm u otras herramientas. La configuración puede almacenarse además junto al código fuente en el sistema de control de versiones, como Git, facilitando la reproducción del entorno en otro equipo.

1.2 Instalación de Mise

Mise-en-place está disponible para los principales sistemas operativos y puede instalarse mediante diferentes métodos, tal como se explica en la documentación. Dependiendo del sistema operativo, tendremos diferentes opciones:

• GNU/Linux: algunas distribuciones permiten la instalación mediante el repositorio propio o añadiendo uno nuevo.
• Windows: permite instalarlo con scoop, winget o chocolatey.
• MacOS: se puede instalar con brew.

Para GNU/Linux y MacOS también se puede usar el instalador proporcionado por el proyecto:

ruben@archy:~$ curl https://mise.run | sh

mise: installed successfully to /home/ruben/.local/bin/mise
mise: run the following to activate mise in your shell:
echo "eval \"\$(/home/ruben/.local/bin/mise activate bash)\"" >> ~/.bashrc

mise: run `mise doctor` to verify this is set up correctly

El instalador realiza las siguientes tareas:

• Descarga el binario y lo guarda dentro del directorio $HOME/.local/bin/.
• Nos indica que tenemos que ejecutar un comando para activar Mise
  • El comando a ejecutar lo que hace guardar el comando para activar Mise, mise activate bash, dentro del fichero de configuración de nuestra SHELL.
    • Normalmente el fichero .bashrc o .zshrc.
  • En el ejemplo anterior se ha ejecutado en una terminal bash.
  • Existen comandos para zsh, fish y powershell de Windows.

Para asegurar que funciona podemos recargar la configuración de la terminal, o cerrarla y abrir una nueva y ejecutar:

ruben@archy:~$ mise doctor

1.3 Desinstalación

Si en algún momento queremos desinstalar Mise y todo lo que hayamos descargado con él, si lo hemos instalado con el instalador explicado en el apartado anterior, la manera más sencilla sería:

ruben@archy:~$ mise implode

Después borrar la línea de activación de Mise que hayamos añadido en nuestro fichero de configuración .bashrc o .zshrc (no el fichero completo).

2.1 Instalar Node.js

Una de las principales utilidades de mise en un proyecto JavaScript es gestionar las versiones de Node.js. En lugar de instalarlo directamente mediante el gestor de paquetes del sistema, podemos dejar que mise se encargue de instalar y seleccionar la versión que necesita cada proyecto.

Para consultar las versiones de Node.js que podemos instalar utilizaremos:

ruben@archy:~$ mise ls-remote node

Este comando muestra las versiones disponibles para su instalación. Nos aparecerá, dependiendo del proyecto, versiones en formato X.Y.Z. Podemos elegir qué versión o sub-versión instalar y dependiendo de lo indicado, mise elegirá la última dentro de la rama indicada.

ruben@archy:~$ mise install node@24.18
✓ installed 1 tool in 2.9s: node@24.18.1

ruben@archy:~$ mise install node@24
✓ installed 1 tool in 2.7s: node@24.21.0

ruben@archy:~$ mise install node@latest
✓ installed 1 tool in 3.1s: node@26.8.2

ruben@archy:~$ mise ls
Tool  Version  Source  Requested 
node  24.18.1 
node  24.21.0 
node  26.8.2

En el ejemplo anterior se han instalado tres versiones de Node:

• 24.18: se ha indicado la sub-version, por lo tanto ha cogido la versión más nueva de esa numeración, siendo la 24.18.1
• 24: al no indicar ninguna sub-versión, ha cogido la última versión disponible, en este momento la 24.21.0
• latest: se descarga la última versión disponible, en este momento la 26.8.2

Tal como se puede ver, se pueden instalar distintas versiones de la misma herramienta, lo que es ideal para hacer pruebas a la hora de querer actualizar de versión y testear nuestro proyecto.

Las herramientas descargadas por defecto se instalan en el directorio del usuario, concretamente en GNU/Linux y MacOS en ~/.local/share/mise. Por lo tanto, si un equipo lo usan distintos desarrolladores, cada usuario puede tener sus herramientas instaladas sin molestar al resto.

ruben@archy:~$ ls ~/.local/share/mise
downloads  installs  migrations  shims

2.2 Seleccionar versión de Node.js

Hasta ahora lo único que hemos hecho ha sido instalar la herramienta indicada, pero no se ha configurado para poder ser usada. Para ello debemos:

ruben@archy:~$ mise use node@24
mise ~/.config/mise/config.toml tools: node@24.21.0

ruben@archy:~$ mise ls
Tool  Version  Source                      Requested 
node  24.18.1 
node  24.21.0  ~/.config/mise/config.toml  24
node  26.8.2  

Con el comando anterior se ha indicado que se use la versión 24 (sin especificar sub-versión), así que coge la última y realiza la configuración en el fichero ~/.config/mise/config.toml porque hemos ejecutado el comando desde nuestra $HOME. Ahora ya se puede usar Node.js dentro de nuestra terminal:

ruben@archy:~$ node -v
v24.21.0

Si seleccionamos una herramienta en cualquier otro directorio nos creará un fichero local mise.toml y ahí se indicará la versión a utilizar. De esta manera, el fichero creado lo podemos añadir a nuestro repositorio de proyecto:

ruben@archy:~/repositorios/proy1 $ mise use node@26
mise ~/repositorios/proy1/mise.toml tools: node@26.8.2

ruben@archy:~/repositorios/proy1 $ cat mise.toml 
[tools]
node = "26"

Si queremos modificar la versión global debemos hacer lo siguiente:

ruben@archy:~/repositorios/proy1 $ mise use --global node@24

De esta manera tenemos dos versiones de Node.js disponibles:

• La versión global: será la v24, que será usada en cualquier parte de nuestro sistema.
• La versión por directorio: al entrar a un directorio que contenga un fichero mise.toml será leído y cambiará a la versión indicada en el proyecto.

2.3 Borrar versión de Node.js

Si tenemos alguna versión de una herramienta que ya no vayamos a usar y queremos eliminarla podemos hacer lo siguiente:

ruben@archy:~/repositorios/proy1 $ mise uninstall node@24.18
✓ removed 1 tool in 199ms: node@24.18.1

ruben@archy:~/repositorios/proy1 $ mise ls
Tool  Version  Source                          Requested 
node  24.21.0 
node  26.8.2   ~/repositorios/proy1/mise.toml  26

Así libramos espacio de nuestro sistema.

3.1 Fichero mise.toml

En un proyecto podemos crear el fichero mise.toml en el que podemos especificar las herramientas y las versiones que necesitamos.

[tools]
node = "24"
bun = "1.4"

De esta forma, cualquier persona que obtenga el proyecto puede saber qué versión principal de Node.js se espera utilizar. mise leerá automáticamente este fichero cuando trabajemos dentro del directorio del proyecto y cambiará a las versiones correspondientes de las herramientas.

3.2 Instalar herramientas definidas

Si nos descargamos un proyecto que contiene un fichero mise.toml debemos asegurar que tenemos instaladas las versiones especificadas. Para ello podemos ejecutar el siguiente comando:

ruben@archy:~/repositorios/proy1 $ mise install
✓ installed 1 tool · 1 already installed in 1.4s: bun@1.4.2

En este caso se ha descargado una herramienta que no teníamos instalada (bun) mientras que otra ya lo estaba. Podemos comprobar las herramientas utilizadas en el proyecto de la siguiente manera:

ruben@archy:~/repositorios/proy1 $ mise current
node 26.8.2
bun 1.4.2