CLI para desarrolladores en Windows · Novedades hasta la versión 1.27.0

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

switchtool.exe
➜switchtool java jdk17 https://.../jdk17.zip
✓ Descarga completada
✓ Descompresión completada
Directorio principal detectado: C:\Users\dev\.switchtool\jdk17
✓ Alias jdk17 agregado a la configuración.
➜switchtool jdk17
Listo: ahora se está usando 'jdk17' para java.
➜

¿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. 1

    Descargá el binario

    Bajá switchtool.exe desde GitHub Releases. Es un único archivo: no necesita instalación.

    Para Windows ARM64, descargá switchtool-arm64.exey renombralo a switchtool.exepara usar los comandos de esta guía.

    Ir a Releases
  2. 2

    Elegí una ubicación fija

    Guardá el .exe en una carpeta duradera, por ejemplo C:\Tools (evitá Descargas o Escritorio).

  3. 3

    Agregá la carpeta al PATH

    Corré esto en PowerShell (ajustá $dir si 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. 4

    Reabrí la terminal y verificá

    Los cambios de PATH se aplican en las sesiones nuevas. Abrí una terminal y probá:

    Terminal
    switchtool --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.

Go 1.24.2+
Terminal
git clone https://github.com/Programmercito/switcher-version-tools.git
cd switcher-version-tools
go build -o switchtool.exe .
Ver el repositorio en GitHub

Uso

Comandos que vas a usar todo el tiempo

Elegí un ejemplo y copiá el comando. La sintaxis es simple: tipo, alias y origen.

PowerShell

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.zip
PowerShell

Instalá desde un .zip que ya tengas en disco.

switchtool php php8.2 C:\Downloads\php-8.2.10-Win32-vs16-x64.zip
PowerShell

Instalá 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.zip
PowerShell

Actualizá el PATH y las variables de entorno de usuario.

switchtool jdk17
switchtool php8.2
PowerShell

Mirá la versión real detectada, el alias, la ruta y cuál está activa.

switchtool list
# o
switchtool ls
PowerShell

Elegí JSON o un alias por línea. También podés desactivar colores.

switchtool list --json
switchtool list --quiet
switchtool --no-color list
PowerShell

Revisá instalaciones, variables y conflictos en el PATH de esta terminal.

switchtool doctor
PowerShell

Borra una versión del registro y del disco.

switchtool remove jdk17

Al 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.

switchtool.json
{
  "tools": {
    "java": "jdk17",
    "node": "node20"
  }
}
Terminal
switchtool project use

La 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.

Sin memorizar alias
  • ↑ ↓ 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.