Instalar Konsolity CLI
Konsolity CLI es el comando konsolity, pensado para instalarse en un servidor o en un equipo sin interfaz gráfica. Una vez activado desde tu cuenta, da acceso a los hosts, los fragmentos y las sesiones de tu bóveda dentro del alcance que le hayas dado, y actúa como servidor MCP local para los agentes de Claude (por ejemplo, Claude Code). Funciona como Claude Code en la línea de comandos: se instala, se activa una vez con un código y ya se puede usar.
Plan necesario
Konsolity CLI está reservado al plan Studio y a su prueba gratuita. El servidor comprueba el plan en cada llamada de la máquina: sin él, cada comando responde «Suscripción requerida». La lista de máquinas y la revocación siguen siempre disponibles, incluso sin el plan.
Elegir la máquina
Cualquier ordenador que pueda llegar a tus hosts por SSH: un servidor de administración, una pequeña máquina virtual, un Mac mini, un equipo de desarrollo, un ejecutor de CI. La máquina no necesita ningún puerto de entrada, solo acceso saliente por HTTPS a api.konsolity.com.
| Sistema | Arquitecturas | Formatos |
|---|---|---|
| Linux (Debian, Ubuntu, Fedora, RHEL y derivadas, cualquier distribución con el archivo comprimido) | x64, arm64 | script, .deb, .rpm, .tar.gz |
| macOS (Intel y Apple silicon) | un archivo por arquitectura (x64, arm64), binario firmado con Developer ID y notarizado · macOS 11 o posterior | script, Homebrew, .tar.gz |
| Windows | x64 | script de PowerShell, .zip |
Linux y macOS: script de instalación
El método más sencillo. El script detecta el sistema y la arquitectura, descarga el archivo adecuado, comprueba su suma SHA-256 y la firma Ed25519 del editor y después lo instala:
curl -fsSL https://konsolity.com/cli/install.sh | sh
Para leer el script antes de ejecutarlo:
curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh
El script se detiene sin instalar nada si la suma o la firma no coinciden.
Linux: paquete .deb (Debian, Ubuntu)
Descarga el paquete de tu arquitectura y, a continuación:
sudo apt install ./konsolity_<version>_amd64.deb
En arm64 (Raspberry Pi 4 o 5, servidores Graviton o Ampere), usa konsolity_<version>_arm64.deb. Después, las actualizaciones pasan por apt.
Linux: paquete .rpm (Fedora, RHEL, Rocky, Alma)
sudo dnf install ./konsolity-<version>.x86_64.rpm
En arm64, el archivo termina en .aarch64.rpm. Después, las actualizaciones pasan por dnf.
Linux: archivo comprimido .tar.gz
Para cualquier otra distribución, el archivo comprimido contiene solo el binario:
tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity
Sustituye amd64 por arm64 en una máquina ARM.
macOS: Homebrew
brew install konsolity/tap/konsolity
Después, las actualizaciones pasan por brew upgrade konsolity. El script de instalación y el archivo konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) también funcionan.
Windows: PowerShell
En PowerShell (sin permisos de administrador):
irm https://konsolity.com/cli/install.ps1 | iex
El script hace las mismas comprobaciones que en Linux, instala konsolity.exe en tu perfil y lo añade al PATH del usuario. Abre un terminal nuevo para usarlo.
Windows: archivo .zip
El archivo konsolity_<version>_windows_amd64.zip contiene konsolity.exe. Descomprímelo en la carpeta que prefieras y añade esa carpeta a tu PATH.
Verificar una descarga
Cada versión se describe en el manifiesto firmado https://konsolity.com/cli/latest.json: versión, lista de archivos (sistema, arquitectura, formato, dirección, suma SHA-256) y firma Ed25519 del editor. Los scripts y konsolity update rechazan un archivo cuya suma o firma no coincidan. Para verificar tú mismo un paquete descargado a mano:
curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb
En macOS, usa shasum -a 256; en Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. La suma mostrada debe ser exactamente la del manifiesto.
Verificar la instalación
konsolity version
El comando muestra la versión, el sistema y la arquitectura.
Actualizar
konsolity update
konsolity update lee el manifiesto, comprueba la suma y la firma de la nueva versión y después sustituye el binario. Si konsolity se instaló con apt, dnf o Homebrew, el comando te remite a ese gestor de paquetes en lugar de sustituir el archivo por sí mismo.
Si el servicio systemd está instalado, ejecute sudo konsolity update: actualiza /usr/local/bin/konsolity y reinicia el servicio. El temporizador konsolity-update.timer también lo hace solo dos veces al día.
Siguientes pasos
- Activar la máquina con un código validado desde tu cuenta.
- Elegir su alcance: hosts, fragmentos, reglas de comandos.
- Descubrir los comandos, conectar Claude Code o ejecutar la CLI como servicio.