Instalación

Instala, comprueba, actualiza o desinstala Clarvis v0.1.1.

La descarga portátil incluye todo lo necesario para ejecutar Clarvis, incluido Bun y las dependencias nativas del terminal. No necesitas instalar Bun, Node.js, un compilador ni un gestor de paquetes. Tampoco necesitas permisos de administrador ni descargar el código fuente.

v0.1.1 es una versión pública oficial 0.x. Las interfaces y los formatos guardados aún pueden cambiar antes de 1.0. Los binarios todavía no están firmados ni notarizados.

Los comandos de esta página corresponden a la versión inmutable v0.1.1. Utiliza la suma de comprobación, el archivo comprimido y el instalador de esa misma versión.

Versión actual

Clarvis v0.1.1 se publica en el repositorio de binarios getclarvis/clarvis-releases. Incluye los seis archivos portátiles, los instaladores POSIX y PowerShell de esa versión, SHA256SUMS y los avisos de licencia correspondientes.

Sistemas y arquitecturas disponibles

Sistema operativo	Arquitecturas	Identificador del paquete	Comprobaciones automáticas
Linux (glibc)	x64, arm64	linux-x64, linux-arm64	Paquete, instalación y primera pantalla del terminal
macOS	Intel, Apple silicon	darwin-x64, darwin-arm64	Paquete, instalación y primera pantalla del terminal
Windows	x64, arm64	windows-x64, windows-arm64	Paquete, instalación y comandos básicos de la CLI

Las pruebas de publicación cubren el empaquetado y la instalación de los seis destinos y verifican que los paquetes públicos no incluyan mapas de código fuente. En Linux y macOS también comprueban la primera pantalla en un pseudoterminal (PTY). En Windows comprueban el manifiesto, --version, --help, la instalación y la reinstalación. Estas pruebas no sustituyen abrir manualmente la interfaz de Windows ni comprobar los avisos de SmartScreen. Para ejecutar sin interfaz interactiva, usa clarvis -p.

Linux y macOS

Se necesitan tar, mktemp, curl y sha256sum o shasum. Los paquetes de Linux son para GNU/glibc; estos archivos portátiles no admiten Alpine ni otras distribuciones que solo usen musl.

Instala la versión publicada con:

curl -fsSL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh | sh

Si prefieres revisar el instalador antes de ejecutarlo, descarga el de la misma versión, examínalo y ejecútalo después:

curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh
vi ./install.sh
sh ./install.sh

La instalación gestionada se guarda por defecto en ${XDG_DATA_HOME:-$HOME/.local/share}/clarvis. Se coloca un pequeño lanzador en ${CLARVIS_BIN_DIR:-${XDG_BIN_HOME:-$HOME/.local/bin}}/clarvis. El instalador no modifica los archivos de inicio del intérprete de comandos. Si el directorio del lanzador no está en PATH, muestra la línea necesaria para añadirlo; puede ser necesario abrir un terminal nuevo.

Windows PowerShell

Windows necesita PowerShell con Invoke-RestMethod (irm), Invoke-Expression (iex), Invoke-WebRequest, Get-FileHash y el tar.exe del sistema.

Instala la versión publicada con:

irm "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" | iex

Para revisar primero el instalador, descarga el archivo de la misma versión inmutable:

Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1"
notepad .\install.ps1
& .\install.ps1

La instalación gestionada usa por defecto %LOCALAPPDATA%\Clarvis. Su directorio bin se añade al PATH del usuario, salvo que hayas definido CLARVIS_SKIP_PATH=1. Si no se encuentra clarvis inmediatamente, vuelve a abrir el terminal.

Qué comprueba el instalador

Para el sistema operativo y la arquitectura detectados, el instalador:

1. descarga el archivo .tar.gz correspondiente y SHA256SUMS de la misma versión;
2. exige una única entrada de suma de comprobación y verifica los bytes descargados;
3. extrae el contenido en un directorio privado de preparación;
4. comprueba que la CLI preparada indique la versión solicitada;
5. se niega a sustituir un comando ajeno o un lanzador POSIX de otra instalación;
6. activa la nueva versión solo cuando todas las comprobaciones han pasado.

Antes de cada fase de descarga, verificación, extracción, prueba de la CLI y activación, muestra la versión, el destino detectado, las rutas y una línea numerada de estado.

Cada paquete incluye un manifiesto release.json con la ruta, el tamaño y el SHA-256 exactos de todos sus archivos. Clarvis vuelve a verificarlo antes de activar una actualización.

Para comprobar un paquete manualmente, descarga el archivo y SHA256SUMS, localiza la línea cuyo nombre coincida exactamente y utiliza la herramienta SHA-256 del sistema. No instales el paquete si el nombre o la suma no coinciden.

Ejecutar y actualizar

clarvis --version
cd /path/to/project
clarvis
clarvis --update

El actualizador solo funciona en instalaciones portátiles gestionadas. No se ejecuta automáticamente al iniciar Clarvis. Prepara y verifica la nueva versión, conserva la anterior y cambia la versión activa al final. Las copias del código fuente y las instalaciones con bun link rechazan la actualización automática: actualízalas mediante Git y el entorno de desarrollo.

Una versión preliminar puede actualizarse a otra preliminar más reciente o a una versión estable posterior. Una instalación estable no selecciona versiones preliminares.

Binarios sin firma

Los binarios de v0.1.1 no están firmados ni notarizados. Gatekeeper de macOS o SmartScreen de Windows pueden solicitar confirmación para abrir una aplicación descargada. Lee el aviso, comprueba la URL y el SHA-256 y utiliza la interfaz normal de aprobación del sistema. Los instaladores de Clarvis no desactivan ni eluden estas protecciones.

Desinstalar Clarvis

Los instaladores públicos de v0.1.1 incluyen un modo de desinstalación con comprobaciones de seguridad. Descarga el instalador de esa misma versión antes de ejecutar el comando.

Linux o macOS:

curl -fL https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.sh -o install.sh
sh ./install.sh --uninstall

Windows PowerShell:

Invoke-WebRequest -Uri "https://github.com/getclarvis/clarvis-releases/releases/download/v0.1.1/install.ps1" -OutFile ".\install.ps1"
& .\install.ps1 -Uninstall

El desinstalador muestra qué va a eliminar y comprueba que los archivos pertenezcan a la instalación seleccionada. Usa el mismo bloqueo exclusivo que las instalaciones y actualizaciones; rechaza archivos ajenos o que estén cambiando al mismo tiempo. En POSIX, el lanzador debe apuntar a la carpeta seleccionada.

Elimina las versiones gestionadas, current, el marcador de instalación y el lanzador correspondiente. En Windows también quita la entrada gestionada de bin del PATH del usuario, aunque ya falte el lanzador. Usa CLARVIS_SKIP_PATH=1 para no modificar PATH.

Rechaza directorios gestionados que sean enlaces y destinos de marcador o activación que no sean archivos. Si cancelas, libera el bloqueo antes de salir. Conserva e identifica los archivos desconocidos y los lanzadores ajenos. Puedes repetir la desinstalación sin cambios, aunque queden esos archivos conservados.

La configuración y las credenciales se guardan por defecto en ~/.clarvis o %USERPROFILE%\.clarvis, fuera de la instalación del binario. Desinstalar la aplicación no las elimina. Bórralas solo después de hacer una copia de lo necesario y confirmar que ya no necesitas las credenciales ni las sesiones.

Si cambiaste las rutas de instalación, pasa los mismos valores de CLARVIS_INSTALL_ROOT y, en POSIX, CLARVIS_BIN_DIR al desinstalador de esa versión. Las variables se documentan en los archivos publicados install.sh e install.ps1.