Gestioná tusversionescomo un profesional
switchtool es un CLI en Go que te permite instalar, cambiar y administrar versiones de Java, Maven, Gradle, PHP, Go, Node.js y pnpm en Windows sin tocar el PATH a mano. Descargá, extraé y configurá todo con un solo comando.
¿Preferís el paso a paso? Mirá la guía de instalación
¿Cómo funciona?
Todo lo aburrido, automatizado
switchtool hace el trabajo pesado para que vos solo te preocupes por codear.
Descarga automática
Instalá desde una URL o un archivo local .zip, .tar.gz o .tgz. Las descargas muestran progreso y reintentan errores transitorios.
PATH inteligente
Olvidate de editar variables de entorno a mano. Limpiá y actualizá el PATH de usuario con PowerShell automáticamente.
Variables de entorno
Configurá JAVA_HOME, MAVEN_HOME, GRADLE_HOME, PHP_HOME, GOROOT, NODE_HOME y PNPM_HOME en el entorno de usuario.
Detección de raíz
¿El ZIP tiene una carpeta intermedia? switchtool la detecta y entra solito, así no tenés que mover archivos.
Cambio en un comando
Pasá de Java 17 a Java 21, o de Node 18 a Node 20, con un único comando: switchtool jdk21.
UI amigable
Colores, barra de progreso, spinners y mensajes claros para que instalar y cambiar versiones sea una experiencia piola.
Diagnóstico del entorno
Con switchtool doctor detectá instalaciones ausentes, variables incorrectas y conflictos con el PATH de la terminal.
Versiones por proyecto
Definí los alias de un proyecto en switchtool.json y activalos explícitamente con switchtool project use.
Listas para scripts
Consultá la versión real detectada y exportá tus instalaciones como JSON o como una lista de alias.
Soportado
Un CLI para gobernarlos a todos
Java, Maven, Gradle, PHP, Go, Node.js y pnpm. Descargá, instalá y cambiá de versión sin salir de la terminal.
Java
JDK
Maven
Build tool
Gradle
Build tool
PHP
Language
Go
GOROOT
Node.js
Runtime
pnpm
PNPM_HOME
Instalación
Instalalo en 4 pasos
Sin instaladores ni dependencias: un solo .exe y cuatro pasos.
- 1
Descargá el binario
Bajá
switchtool.exedesde GitHub Releases. Es un único archivo: no necesita instalación.Para Windows ARM64, descargá
Ir a Releasesswitchtool-arm64.exey renombralo aswitchtool.exepara usar los comandos de esta guía. - 2
Elegí una ubicación fija
Guardá el
.exeen una carpeta duradera, por ejemploC:\Tools(evitá Descargas o Escritorio). - 3
Agregá la carpeta al PATH
Corré esto en PowerShell (ajustá
$dirsi usaste otra carpeta), o hacelo desde Configuración → Editar variables de entorno del sistema.PowerShell$dir = "C:\Tools" $path = [Environment]::GetEnvironmentVariable("Path", "User") [Environment]::SetEnvironmentVariable("Path", "$path;$dir", "User") - 4
Reabrí la terminal y verificá
Los cambios de PATH se aplican en las sesiones nuevas. Abrí una terminal y probá:
Terminalswitchtool --version
Y listo: se acabó el .\switchtool.exe
Con la carpeta en el PATH, escribís solo switchtool desde cualquier directorio. Si la terminal no lo encuentra, reabrila: es el paso que más se olvida.
Para desarrolladores
Compilá desde el código fuente
Si querés la última versión o querés contribuir, cloná el repo y compilalo con Go.
Build manual
Requiere Go 1.24.2 o posterior instalado en tu sistema.
git clone https://github.com/Programmercito/switcher-version-tools.git
cd switcher-version-tools
go build -o switchtool.exe .Uso
Comandos que vas a usar todo el tiempo
Elegí un ejemplo y copiá el comando. La sintaxis es simple: tipo, alias y origen.
Descargá un JDK de Adoptium y dejalo listo para usar.
switchtool java jdk17 https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.9%2B9/OpenJDK17U-jdk_x64_windows_hotspot_17.0.9_9.zipInstalá desde un .zip que ya tengas en disco.
switchtool php php8.2 C:\Downloads\php-8.2.10-Win32-vs16-x64.zipInstalá la distribución standalone de pnpm para Windows.
switchtool pnpm v12.11.2 https://github.com/pnpm/pnpm/releases/download/v12.11.2/pnpm-win32-x64.zipActualizá el PATH y las variables de entorno de usuario.
switchtool jdk17
switchtool php8.2Mirá la versión real detectada, el alias, la ruta y cuál está activa.
switchtool list
# o
switchtool lsElegí JSON o un alias por línea. También podés desactivar colores.
switchtool list --json
switchtool list --quiet
switchtool --no-color listRevisá instalaciones, variables y conflictos en el PATH de esta terminal.
switchtool doctorBorra una versión del registro y del disco.
switchtool remove jdk17Al cambiar de versión, abrí una terminal nueva o actualizá el entorno de la sesión: los cambios persistidos no se aplican automáticamente a la terminal actual.
Activá las herramientas de un proyecto
Creá switchtool.json en el directorio desde el que ejecutás el comando. Los alias deben estar instalados previamente para cada herramienta.
{
"tools": {
"java": "jdk17",
"node": "node20"
}
}switchtool project useLa activación es explícita y cambia las versiones globales de tu usuario en Windows; no se aplica automáticamente al entrar al directorio. Si un cambio de entorno falla, los cambios anteriores podrían haber quedado aplicados.
Menú interactivo
Si no querés recordar alias, corré switchtool sin argumentos (o switchtool use) y elegí el lenguaje y la versión con el teclado.
- ↑ ↓ o j k moverse por la lista
- Enter confirmar la opción
- ← volver al paso anterior
- / filtrar la lista
- Esc salir
- La versión activa aparece marcada con ✓ actual
Si solo tenés un lenguaje (o una sola versión), el paso se omite. Con switchtool remove(sin alias) elegís qué eliminar de la misma forma, con confirmación previa.