Vai al contenuto

// konsolity cli

Konsolity dalla riga di comando, sui tuoi server.

Come Claude Code in un terminale: il binario konsolity si installa con una riga su un server Linux, un Mac o Windows, si attiva con un codice approvato dal tuo account e poi dà accesso agli host, agli snippet e alle sessioni che gli affidi. Fa anche da server MCP locale per gli agenti Claude.

// installazione

Una riga per installare.

Linux x64 e arm64, macOS su Intel e Apple silicon, Windows x64. Gli installer verificano il checksum SHA-256 e la firma dell'editore prima di installare qualsiasi cosa.

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

Pacchetti .deb e .rpm per Debian, Ubuntu, Fedora, RHEL e derivate, archivi .tar.gz e .zip, con il loro checksum SHA-256: Download

// attivazione

Attivata con un codice, mai con una password.

Sulla macchina non si digita mai alcuna password né alcuna chiave.

1

Avvia konsolity login

Il comando mostra un indirizzo, un codice XXXX-XXXX e l'impronta della macchina, con un codice QR se il terminale lo consente.

2

Approva dal tuo account

Inserisci il codice nell'app (Impostazioni, Macchine CLI) o apri app.konsolity.com/cli/activate, e verifica che l'impronta sia la stessa del terminale.

3

Scegli l'ambito

Host, snippet, sessioni, MCP; sola lettura o accesso completo; regole dei comandi; scadenza da un giorno a un anno, oppure mai.

4

Conferma con un secondo fattore

Codice di autenticazione a due fattori o passkey, nella stessa approvazione. Senza secondo fattore sull'account non si può attivare nessuna macchina.

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

$ konsolity status

// ambito

La macchina vede solo ciò che le affidi.

L'ambito si sceglie all'attivazione e si modifica poi dalla pagina Macchine CLI. Ampliarlo richiede un secondo fattore, ridurlo è immediato.

Host

Gli host scelti, le loro identità e le loro chiavi host fissate. Un host fuori dall'ambito non viene mai copiato sulla macchina.

Snippet

Gli snippet scelti, da elencare o da eseguire su un host dell'ambito.

Sessioni

Le sessioni CLI in corso sull'account, da seguire o da chiudere.

MCP

Il server MCP locale per Claude Code e gli agenti Claude, e la coda del connettore Claude con konsolity serve.

Sola lettura o accesso completo

In sola lettura la macchina elenca e mostra lo stato senza eseguire alcun comando. Con accesso completo esegue ciò che le tue regole consentono.

Regole dei comandi

Modelli consentiti (esatto, prefisso o glob) e durata massima. Il server e la macchina rifiutano entrambi ciò che non è permesso.

// sicurezza

Una cassaforte di macchina, cifrata end-to-end.

Konsolity CLI mantiene il modello di Konsolity: il server non legge né i tuoi host, né le tue chiavi, né le tue regole.

La chiave della cassaforte resta sui tuoi dispositivi

La macchina non riceve mai la chiave della tua cassaforte. Il dispositivo che approva le consegna una chiave di macchina sigillata solo per lei, poi copie cifrate dei soli elementi autorizzati.

Legata alla macchina

Il token è legato all'impronta della macchina: copiato altrove viene rifiutato e ricevi un avviso. I segreti locali sono cifrati con una chiave propria della macchina.

Rotazione automatica

Il token viene rinnovato automaticamente ogni 24 ore, senza interruzione del servizio.

Revoca in meno di 5 secondi

Revoca una macchina o chiudi una sessione dall'app o dal tuo account: connessioni interrotte, comando fermato, segreti locali cancellati.

Comandi distruttivi confermati

rm -rf, DROP, reboot, terraform destroy e gli altri comandi distruttivi attendono la tua approvazione nell'app, qualunque sia l'ambito. Senza risposta entro 5 minuti non viene eseguito nulla.

Tutto viene registrato

Attivazione, ogni comando e il suo codice di uscita, conferme, rotazioni, revoca. Mai l'output né un segreto. Esportazione in CSV o JSON.

Avvisi

Nuova macchina, impronta diversa, revoca, richiesta di conferma: via e-mail, nell'app e su Telegram se lo hai collegato.

Secondo fattore obbligatorio

Attivare una macchina o ampliarne l'ambito richiede un codice di autenticazione a due fattori o una passkey.

// mcp

Un server MCP locale per Claude.

konsolity mcp offre a Claude Code e agli agenti Claude gli strumenti list_hosts, list_snippets, run_command, run_snippet e list_sessions, con lo stesso ambito, le stesse regole e le stesse conferme. Basta una riga per collegarlo.

$ claude mcp add konsolity -- konsolity mcp

Con konsolity serve la macchina preleva anche la coda del connettore Claude del tuo account, come fa l'app desktop, senza che questa debba essere aperta. Connettore Claude

// comandi

I comandi principali.

konsolity loginAttiva la macchina con un codice approvato dal tuo account.
konsolity statusAccount, macchina, ambito, scadenza, età del token e host raggiungibili.
konsolity hostsElenca gli host dell'ambito, senza alcun segreto.
konsolity run <host> -- <command>Esegue un comando via SSH su un host, con output in diretta e codice di uscita trasmesso.
konsolity snippet list · runElenca gli snippet o ne esegue uno su un host.
konsolity sessions [--follow]Segue le sessioni CLI in corso sull'account o ne chiude una.
konsolity mcpServer MCP locale (stdio) per Claude.
konsolity servePreleva la coda del connettore Claude, come servizio di sistema.
konsolity setup-tokenToken a lunga durata per una CI o un container, mostrato una sola volta.
konsolity updateAggiorna il binario dopo aver verificato la firma.
konsolity logoutRevoca la macchina e cancella tutto in locale.

// studio

Incluso nel piano Studio.

Studio costa 99 € al mese o 999 € all'anno. Konsolity CLI è riservato a Studio e alla sua prova gratuita di 7 giorni, come il connettore Claude. Il server verifica il piano a ogni chiamata della macchina.

Prova gratuita di 7 giorni Guida all'installazione Connettore Claude

// faq

Domande frequenti

Il server di Konsolity può leggere ciò che riceve la macchina?

No. Gli elementi copiati per la macchina sono cifrati con una chiave di macchina che conoscono solo i tuoi dispositivi e la macchina. Il server conserva solo blocchi opachi, e la macchina non riceve mai la chiave della tua cassaforte.

E se la macchina viene rubata o compromessa?

Revocala dalla pagina Macchine CLI: viene disconnessa in meno di 5 secondi e le sue copie vengono cancellate dal server. Sono interessati solo gli host del suo ambito; per prudenza, cambia le loro chiavi SSH.

Bisogna tenere l'app aperta?

No. La macchina lavora da sola entro il suo ambito. L'app serve ad attivarla, a modificarne l'ambito e a confermare i comandi distruttivi, e può stare sul tuo telefono.

Quali sistemi sono supportati?

Linux x64 e arm64 (Debian, Ubuntu, Fedora, RHEL e derivate, o qualsiasi distribuzione tramite l'archivio), macOS su Intel e Apple silicon, e Windows x64.

Posso usarlo in una CI o in un container?

Sì, con konsolity setup-token: un token a lunga durata, mostrato una sola volta, da conservare nel tuo gestore di segreti e da fornire tramite KONSOLITY_TOKEN. Ha un ambito, un registro e una revoca come una macchina.

Quale piano serve?

Studio, prova gratuita di 7 giorni compresa. Per attivare una macchina, l'account deve avere anche l'autenticazione a due fattori o una passkey.