Konsolity CLI installeren
Konsolity CLI is de opdracht konsolity, bedoeld voor een server of een machine zonder grafische interface. Na activering vanuit je account geeft hij toegang tot de hosts, snippets en sessies van je kluis binnen het bereik dat je hem hebt gegeven, en dient hij als lokale MCP-server voor Claude-agents (bijvoorbeeld Claude Code). Hij werkt zoals Claude Code op de opdrachtregel: je installeert hem, activeert hem één keer met een code en gebruikt hem daarna.
Vereist abonnement
Konsolity CLI is voorbehouden aan het abonnement Studio en de gratis proefperiode daarvan. De server controleert het abonnement bij elke aanroep van de machine: zonder dit abonnement antwoordt elke opdracht met "Abonnement vereist". De lijst met machines en het intrekken blijven altijd beschikbaar, ook zonder abonnement.
De machine kiezen
Elke computer die je hosts via SSH kan bereiken: een beheerserver, een kleine virtuele machine, een Mac mini, een ontwikkelwerkstation, een CI-runner. De machine heeft geen inkomende poort nodig, alleen uitgaande HTTPS-toegang tot api.konsolity.com.
| Systeem | Architecturen | Formaten |
|---|---|---|
| Linux (Debian, Ubuntu, Fedora, RHEL en afgeleiden, elke distributie via het archief) | x64, arm64 | script, .deb, .rpm, .tar.gz |
| macOS (Intel en Apple silicon) | één archief per architectuur (x64, arm64), binair bestand ondertekend met Developer ID en genotariseerd · macOS 11 of nieuwer | script, Homebrew, .tar.gz |
| Windows | x64 | PowerShell-script, .zip |
Linux en macOS: installatiescript
De eenvoudigste manier. Het script herkent het systeem en de architectuur, downloadt het juiste bestand, controleert de SHA-256-hash en de Ed25519-handtekening van de uitgever en installeert het daarna:
curl -fsSL https://konsolity.com/cli/install.sh | sh
Om het script te lezen voordat je het uitvoert:
curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh
Het script stopt zonder iets te installeren als de hash of de handtekening niet overeenkomt.
Linux: .deb-pakket (Debian, Ubuntu)
Download het pakket voor je architectuur en voer daarna uit:
sudo apt install ./konsolity_<version>_amd64.deb
Op arm64 (Raspberry Pi 4 of 5, Graviton- of Ampere-servers) neem je konsolity_<version>_arm64.deb. Updates verlopen daarna via apt.
Linux: .rpm-pakket (Fedora, RHEL, Rocky, Alma)
sudo dnf install ./konsolity-<version>.x86_64.rpm
Op arm64 eindigt het bestand op .aarch64.rpm. Updates verlopen daarna via dnf.
Linux: .tar.gz-archief
Voor elke andere distributie bevat het archief alleen het binaire bestand:
tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity
Vervang amd64 door arm64 op een ARM-machine.
macOS: Homebrew
brew install konsolity/tap/konsolity
Updates verlopen daarna via brew upgrade konsolity. Het installatiescript en het archief konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) werken ook.
Windows: PowerShell
In PowerShell (geen beheerdersrechten nodig):
irm https://konsolity.com/cli/install.ps1 | iex
Het script voert dezelfde controles uit als op Linux, installeert konsolity.exe in je profiel en voegt het toe aan het PATH van de gebruiker. Open een nieuwe terminal om het te gebruiken.
Windows: .zip-archief
Het archief konsolity_<version>_windows_amd64.zip bevat konsolity.exe. Pak het uit in een map naar keuze en voeg die map toe aan je PATH.
Een download controleren
Elke versie wordt beschreven door het ondertekende manifest https://konsolity.com/cli/latest.json: versie, lijst met bestanden (systeem, architectuur, formaat, adres, SHA-256-hash) en de Ed25519-handtekening van de uitgever. De scripts en konsolity update weigeren een bestand waarvan de hash of de handtekening niet overeenkomt. Om zelf een handmatig gedownload pakket te controleren:
curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb
Gebruik op macOS shasum -a 256, op Windows Get-FileHash konsolity_<version>_windows_amd64.zip. De getoonde hash moet exact gelijk zijn aan die in het manifest.
De installatie controleren
konsolity version
De opdracht toont de versie, het systeem en de architectuur.
Bijwerken
konsolity update
konsolity update leest het manifest, controleert de hash en de handtekening van de nieuwe versie en vervangt daarna het binaire bestand. Als konsolity met apt, dnf of Homebrew is geïnstalleerd, verwijst de opdracht je naar die pakketbeheerder in plaats van het bestand zelf te vervangen.
Is de systemd-service geïnstalleerd, voer dan sudo konsolity update uit: dat werkt /usr/local/bin/konsolity bij en herstart de service. De timer konsolity-update.timer doet dit ook zelf twee keer per dag.
Volgende stappen
- Activeer de machine met een code die je vanuit je account goedkeurt.
- Kies het bereik: hosts, snippets, regels voor opdrachten.
- Ontdek de opdrachten, koppel Claude Code of draai hem als service.