Instalarea Konsolity CLI
Konsolity CLI este comanda konsolity, de instalat pe un server sau pe o mașină fără interfață grafică. Odată activată din contul dumneavoastră, oferă acces la gazdele, fragmentele și sesiunile din seif în limitele domeniului pe care i l-ați acordat și servește drept server MCP local pentru agenții Claude (de exemplu Claude Code). Funcționează ca Claude Code în linia de comandă: o instalați, o activați o singură dată cu un cod, apoi o folosiți.
Plan necesar
Konsolity CLI este rezervat planului Studio și perioadei sale de probă gratuite. Serverul verifică planul la fiecare apel al mașinii: fără acesta, fiecare comandă răspunde „Abonament necesar”. Lista mașinilor și revocarea rămân mereu disponibile, chiar și fără plan.
Alegerea mașinii
Orice computer care vă poate accesa gazdele prin SSH: un server de administrare, o mașină virtuală mică, un Mac mini, o stație de dezvoltare, un runner CI. Mașina nu are nevoie de niciun port de intrare, ci doar de acces HTTPS de ieșire către api.konsolity.com.
| Sistem | Arhitecturi | Formate |
|---|---|---|
| Linux (Debian, Ubuntu, Fedora, RHEL și derivate, orice distribuție prin arhivă) | x64, arm64 | script, .deb, .rpm, .tar.gz |
| macOS (Intel și Apple silicon) | o arhivă pentru fiecare arhitectură (x64, arm64), binar semnat Developer ID și notarizat · macOS 11 sau mai nou | script, Homebrew, .tar.gz |
| Windows | x64 | script PowerShell, .zip |
Linux și macOS: script de instalare
Cea mai simplă metodă. Scriptul detectează sistemul și arhitectura, descarcă fișierul potrivit, verifică hash-ul SHA-256 și semnătura Ed25519 a editorului, apoi îl instalează:
curl -fsSL https://konsolity.com/cli/install.sh | sh
Pentru a citi scriptul înainte de a-l rula:
curl -fsSLO https://konsolity.com/cli/install.sh
less install.sh
sh install.sh
Scriptul se oprește fără să instaleze nimic dacă hash-ul sau semnătura nu corespund.
Linux: pachet .deb (Debian, Ubuntu)
Descărcați pachetul pentru arhitectura dumneavoastră, apoi:
sudo apt install ./konsolity_<version>_amd64.deb
Pe arm64 (Raspberry Pi 4 sau 5, servere Graviton sau Ampere), luați konsolity_<version>_arm64.deb. Actualizările se fac apoi prin apt.
Linux: pachet .rpm (Fedora, RHEL, Rocky, Alma)
sudo dnf install ./konsolity-<version>.x86_64.rpm
Pe arm64, fișierul se termină cu .aarch64.rpm. Actualizările se fac apoi prin dnf.
Linux: arhivă .tar.gz
Pentru orice altă distribuție, arhiva conține doar binarul:
tar -xzf konsolity_<version>_linux_amd64.tar.gz
sudo install -m 0755 konsolity /usr/local/bin/konsolity
Înlocuiți amd64 cu arm64 pe o mașină ARM.
macOS: Homebrew
brew install konsolity/tap/konsolity
Actualizările se fac apoi prin brew upgrade konsolity. Scriptul de instalare și arhiva konsolity-<version>-macos-x64.tar.gz (Intel) / konsolity-<version>-macos-arm64.tar.gz (Apple silicon) funcționează de asemenea.
Windows: PowerShell
În PowerShell (nu sunt necesare drepturi de administrator):
irm https://konsolity.com/cli/install.ps1 | iex
Scriptul face aceleași verificări ca pe Linux, instalează konsolity.exe în profilul dumneavoastră și îl adaugă în PATH-ul utilizatorului. Deschideți un terminal nou pentru a-l folosi.
Windows: arhivă .zip
Arhiva konsolity_<version>_windows_amd64.zip conține konsolity.exe. Extrageți-o într-un dosar ales de dumneavoastră, apoi adăugați acel dosar în PATH.
Verificarea unei descărcări
Fiecare versiune este descrisă de manifestul semnat https://konsolity.com/cli/latest.json: versiunea, lista fișierelor (sistem, arhitectură, format, adresă, hash SHA-256) și semnătura Ed25519 a editorului. Scripturile și konsolity update refuză un fișier al cărui hash sau semnătură nu corespunde. Pentru a verifica singur un pachet descărcat manual:
curl -fsSL https://konsolity.com/cli/latest.json
sha256sum konsolity_<version>_amd64.deb
Pe macOS, folosiți shasum -a 256; pe Windows, Get-FileHash konsolity_<version>_windows_amd64.zip. Hash-ul afișat trebuie să fie exact cel din manifest.
Verificarea instalării
konsolity version
Comanda afișează versiunea, sistemul și arhitectura.
Actualizare
konsolity update
konsolity update citește manifestul, verifică hash-ul și semnătura noii versiuni, apoi înlocuiește binarul. Dacă konsolity a fost instalat cu apt, dnf sau Homebrew, comanda vă trimite la acel manager de pachete în loc să înlocuiască ea însăși fișierul.
Dacă serviciul systemd este instalat, rulați sudo konsolity update: comanda actualizează /usr/local/bin/konsolity, apoi repornește serviciul. Temporizatorul konsolity-update.timer face asta și singur de două ori pe zi.
Pașii următori
- Activați mașina cu un cod aprobat din contul dumneavoastră.
- Alegeți-i domeniul: gazde, fragmente, reguli de comenzi.
- Descoperiți comenzile, conectați Claude Code sau rulați-o ca serviciu.