Installare Konsolity CLI

Aggiornato il 10 novembre 2026

Konsolity CLI è il comando konsolity, da installare su un server o su un computer senza interfaccia grafica. Una volta attivato dal tuo account, dà accesso agli host, agli snippet e alle sessioni della tua cassaforte entro i limiti dell'ambito che gli hai assegnato, e funge da server MCP locale per gli agenti Claude (ad esempio Claude Code). Funziona come Claude Code a riga di comando: lo installi, lo attivi una volta con un codice, poi lo usi.

Piano richiesto

Konsolity CLI è riservato al piano Studio e alla sua prova gratuita. Il server verifica il piano a ogni chiamata della macchina: senza Studio, ogni comando risponde «Abbonamento necessario». L'elenco delle macchine e la revoca restano sempre disponibili, anche senza il piano.

Scegliere la macchina

Qualsiasi computer in grado di raggiungere i tuoi host via SSH: un server di amministrazione, una piccola macchina virtuale, un Mac mini, una postazione di sviluppo, un runner di CI. La macchina non ha bisogno di nessuna porta in ingresso, solo di un accesso HTTPS in uscita verso api.konsolity.com.

Sistema Architetture Formati
Linux (Debian, Ubuntu, Fedora, RHEL e derivate, qualsiasi distribuzione tramite l'archivio) x64, arm64 script, .deb, .rpm, .tar.gz
macOS (Intel e Apple silicon) un archivio per architettura (x64, arm64), binario firmato Developer ID e notarizzato · macOS 11 o successivo script, Homebrew, .tar.gz
Windows x64 script PowerShell, .zip

Linux e macOS: script di installazione

Il metodo più semplice. Lo script rileva il sistema e l'architettura, scarica il file giusto, verifica il suo hash SHA-256 e la firma Ed25519 dell'editore, poi lo installa:

curl -fsSL https://konsolity.com/cli/install.sh | sh

Per leggere lo script prima di eseguirlo:

curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh

Lo script si interrompe senza installare nulla se l'hash o la firma non corrispondono.

Linux: pacchetto .deb (Debian, Ubuntu)

Scarica il pacchetto per la tua architettura, poi:

sudo apt install ./konsolity_<version>_amd64.deb

Su arm64 (Raspberry Pi 4 o 5, server Graviton o Ampere), prendi konsolity_<version>_arm64.deb. Gli aggiornamenti passano poi da apt.

Linux: pacchetto .rpm (Fedora, RHEL, Rocky, Alma)

sudo dnf install ./konsolity-<version>.x86_64.rpm

Su arm64, il file termina con .aarch64.rpm. Gli aggiornamenti passano poi da dnf.

Linux: archivio .tar.gz

Per qualsiasi altra distribuzione, l'archivio contiene solo il binario:

tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity

Sostituisci amd64 con arm64 su una macchina ARM.

macOS: Homebrew

brew install konsolity/tap/konsolity

Gli aggiornamenti passano poi da brew upgrade konsolity. Funzionano anche lo script di installazione e l'archivio konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon).

Windows: PowerShell

In PowerShell (non servono diritti di amministratore):

irm https://konsolity.com/cli/install.ps1 | iex

Lo script esegue gli stessi controlli che su Linux, installa konsolity.exe nel tuo profilo e lo aggiunge al PATH dell'utente. Apri un nuovo terminale per usarlo.

Windows: archivio .zip

L'archivio konsolity_<version>_windows_amd64.zip contiene konsolity.exe. Estrailo in una cartella a tua scelta, poi aggiungi quella cartella al tuo PATH.

Verificare un download

Ogni versione è descritta dal manifesto firmato https://konsolity.com/cli/latest.json: versione, elenco dei file (sistema, architettura, formato, indirizzo, hash SHA-256) e firma Ed25519 dell'editore. Gli script e konsolity update rifiutano un file il cui hash o la cui firma non corrispondono. Per verificare tu stesso un pacchetto scaricato a mano:

curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb

Su macOS, usa shasum -a 256; su Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. L'hash mostrato deve essere esattamente quello del manifesto.

Verificare l'installazione

konsolity version

Il comando mostra la versione, il sistema e l'architettura.

Aggiornare

konsolity update

konsolity update legge il manifesto, verifica l'hash e la firma della nuova versione, poi sostituisce il binario. Se konsolity è stato installato con apt, dnf o Homebrew, il comando ti rimanda a quel gestore di pacchetti invece di sostituire il file da solo.

Se il servizio systemd è installato, esegui sudo konsolity update: aggiorna /usr/local/bin/konsolity, poi riavvia il servizio. Il timer konsolity-update.timer lo fa anche da solo due volte al giorno.

Passi successivi

  1. Attiva la macchina con un codice approvato dal tuo account.
  2. Scegli il suo ambito: host, snippet, regole dei comandi.
  3. Scopri i comandi, collega Claude Code o eseguilo come servizio.