Installare Konsolity CLI
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
- Attiva la macchina con un codice approvato dal tuo account.
- Scegli il suo ambito: host, snippet, regole dei comandi.
- Scopri i comandi, collega Claude Code o eseguilo come servizio.