Instalar Konsolity CLI

Actualizado el 10 de noviembre de 2026

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

  1. Activar la máquina con un código validado desde tu cuenta.
  2. Elegir su alcance: hosts, fragmentos, reglas de comandos.
  3. Descubrir los comandos, conectar Claude Code o ejecutar la CLI como servicio.