Ir al contenido

// konsolity cli

Konsolity en la línea de comandos, en tus servidores.

Como Claude Code en un terminal: el binario konsolity se instala con una línea en un servidor Linux, un Mac o Windows, se activa con un código aprobado desde tu cuenta y luego da acceso a los hosts, snippets y sesiones que le confías. También sirve de servidor MCP local para los agentes de Claude.

// instalación

Una línea para instalar.

Linux x64 y arm64, macOS en Intel y Apple silicon, Windows x64. Los instaladores comprueban la suma SHA-256 y la firma del editor antes de instalar nada.

Linux y macOScurl -fsSL https://konsolity.com/cli/install.sh | sh
Windows (PowerShell)irm https://konsolity.com/cli/install.ps1 | iex
Homebrewbrew install konsolity/tap/konsolity

Paquetes .deb y .rpm para Debian, Ubuntu, Fedora, RHEL y derivadas, archivos .tar.gz y .zip, con su suma SHA-256: Descargar

// activación

Se activa con un código, nunca con una contraseña.

En la máquina nunca se escribe ninguna contraseña ni ninguna clave.

1

Ejecuta konsolity login

El comando muestra una dirección, un código XXXX-XXXX y la huella de la máquina, con un código QR si el terminal lo permite.

2

Aprueba desde tu cuenta

Introduce el código en la app (Ajustes, Máquinas CLI) o abre app.konsolity.com/cli/activate, y comprueba que la huella es la misma que en el terminal.

3

Elige el alcance

Hosts, snippets, sesiones, MCP; solo lectura o acceso completo; reglas de comandos; caducidad de un día a un año, o nunca.

4

Confirma con un segundo factor

Código de verificación en dos pasos o llave de acceso, en la misma aprobación. Sin segundo factor en la cuenta, no se puede activar ninguna máquina.

$ konsolity login --name web-01
  https://app.konsolity.com/cli/activate
  code         KQ7M-4TZP
  fingerprint  9F3A-C21D

$ konsolity status

// alcance

La máquina solo ve lo que le confías.

El alcance se elige en la activación y se modifica después desde la página Máquinas CLI. Ampliarlo exige un segundo factor; reducirlo es inmediato.

Hosts

Los hosts elegidos, sus identidades y sus claves de host fijadas. Un host fuera del alcance nunca se copia en la máquina.

Snippets

Los snippets elegidos, para listarlos o ejecutarlos en un host del alcance.

Sesiones

Las sesiones CLI en curso de la cuenta, para seguirlas o terminarlas.

MCP

El servidor MCP local para Claude Code y los agentes de Claude, y la cola del conector de Claude con konsolity serve.

Solo lectura o acceso completo

En solo lectura, la máquina lista y muestra el estado sin ejecutar ningún comando. Con acceso completo, ejecuta lo que tus reglas permiten.

Reglas de comandos

Patrones permitidos (exacto, prefijo o glob) y duración máxima. El servidor y la máquina rechazan ambos lo que no está permitido.

// seguridad

Una bóveda de máquina, cifrada de extremo a extremo.

Konsolity CLI mantiene el modelo de Konsolity: el servidor no lee ni tus hosts, ni tus claves, ni tus reglas.

La clave de la bóveda se queda en tus dispositivos

La máquina nunca recibe la clave de tu bóveda. El dispositivo que aprueba le entrega una clave de máquina sellada solo para ella y, después, copias cifradas únicamente de los elementos autorizados.

Vinculada a la máquina

El token está vinculado a la huella de la máquina: copiado en otro lugar, se rechaza y recibes una alerta. Los secretos locales se cifran con una clave propia de la máquina.

Rotación automática

El token se renueva automáticamente cada 24 horas, sin interrupción del servicio.

Revocación en menos de 5 segundos

Revoca una máquina o termina una sesión desde la app o tu cuenta: conexiones cortadas, comando detenido, secretos locales borrados.

Comandos destructivos confirmados

rm -rf, DROP, reboot, terraform destroy y los demás comandos destructivos esperan tu aprobación en la app, sea cual sea el alcance. Sin respuesta en 5 minutos, no se ejecuta nada.

Todo queda registrado

Activación, cada comando y su código de salida, confirmaciones, rotaciones, revocación. Nunca la salida ni un secreto. Exportación en CSV o JSON.

Alertas

Nueva máquina, huella distinta, revocación, solicitud de confirmación: por correo electrónico, en la app y en Telegram si lo has vinculado.

Segundo factor obligatorio

Activar una máquina o ampliar su alcance exige un código de verificación en dos pasos o una llave de acceso.

// mcp

Un servidor MCP local para Claude.

konsolity mcp ofrece a Claude Code y a los agentes de Claude las herramientas list_hosts, list_snippets, run_command, run_snippet y list_sessions, con el mismo alcance, las mismas reglas y las mismas confirmaciones. Basta una línea para conectarlo.

$ claude mcp add konsolity -- konsolity mcp

Con konsolity serve, la máquina también recoge la cola del conector de Claude de tu cuenta, como hace la app de escritorio, sin que esta tenga que estar abierta. Conector Claude

// comandos

Los comandos principales.

konsolity loginActiva la máquina con un código aprobado desde tu cuenta.
konsolity statusCuenta, máquina, alcance, caducidad, antigüedad del token y hosts accesibles.
konsolity hostsLista los hosts del alcance, sin ningún secreto.
konsolity run <host> -- <command>Ejecuta un comando por SSH en un host, con la salida en directo y el código de salida transmitido.
konsolity snippet list · runLista los snippets o ejecuta uno en un host.
konsolity sessions [--follow]Sigue las sesiones CLI en curso de la cuenta o termina una.
konsolity mcpServidor MCP local (stdio) para Claude.
konsolity serveRecoge la cola del conector de Claude, como servicio del sistema.
konsolity setup-tokenToken de larga duración para una CI o un contenedor, mostrado una sola vez.
konsolity updateActualiza el binario tras comprobar la firma.
konsolity logoutRevoca la máquina y lo borra todo localmente.

// studio

Incluido en el plan Studio.

Studio cuesta 99 € al mes o 999 € al año. Konsolity CLI está reservado a Studio y a su prueba gratuita de 7 días, como el conector de Claude. El servidor comprueba el plan en cada llamada de la máquina.

Prueba gratuita de 7 días Guía de instalación Conector Claude

// faq

Preguntas frecuentes

¿Puede el servidor de Konsolity leer lo que recibe la máquina?

No. Los elementos copiados para la máquina se cifran con una clave de máquina que solo conocen tus dispositivos y la máquina. El servidor solo guarda bloques opacos, y la máquina nunca recibe la clave de tu bóveda.

¿Y si roban la máquina o la comprometen?

Revócala desde la página Máquinas CLI: queda cortada en menos de 5 segundos y sus copias se borran del servidor. Solo afecta a los hosts de su alcance; por precaución, cambia sus claves SSH.

¿Hay que mantener la app abierta?

No. La máquina trabaja sola dentro de su alcance. La app sirve para activarla, modificar su alcance y confirmar los comandos destructivos, y puede estar en tu teléfono.

¿Qué sistemas son compatibles?

Linux x64 y arm64 (Debian, Ubuntu, Fedora, RHEL y derivadas, o cualquier distribución mediante el archivo), macOS en Intel y Apple silicon, y Windows x64.

¿Puedo usarlo en una CI o un contenedor?

Sí, con konsolity setup-token: un token de larga duración, mostrado una sola vez, que guardas en tu gestor de secretos y proporcionas mediante KONSOLITY_TOKEN. Tiene un alcance, un registro y una revocación como una máquina.

¿Qué plan necesito?

Studio, con la prueba gratuita de 7 días incluida. Para activar una máquina, la cuenta también necesita la verificación en dos pasos o una llave de acceso.