Referința comenzilor
Fiecare comandă se scrie konsolity <command> [options]. konsolity help și konsolity <command> --help afișează ajutorul în limba sistemului. Ieșirile --json sunt stabile și destinate scripturilor; nu conțin niciodată un secret.
Prezentare generală
| Comandă | Domeniu necesar | Rol |
|---|---|---|
login |
Activează mașina (Activarea unei mașini) | |
setup-token |
Creează un token de lungă durată pentru CI și containere | |
status |
Cont, mașină, domeniu, expirare, stare | |
hosts |
hosts |
Gazdele din domeniu |
run |
hosts, acces complet |
Rulează o comandă pe o gazdă |
snippet list |
snippets |
Fragmentele din domeniu |
snippet run |
snippets + hosts, acces complet |
Rulează un fragment pe o gazdă |
sessions |
sessions |
Sesiunile CLI în curs pe cont |
sessions end |
sessions |
Încheie o sesiune |
mcp |
mcp |
Server MCP local pentru Claude Code (MCP local) |
serve |
mcp + integrarea Claude |
Tratează cererile conectorului Claude (Serviciu) |
service install |
Instalează serve ca serviciu de sistem |
|
rotate |
Reînnoiește tokenul mașinii | |
policy |
Afișează domeniul și regulile aplicate | |
logout |
Revocă mașina și șterge totul local | |
version |
Versiune, sistem, arhitectură | |
update |
Actualizează binarul (semnătură verificată) |
O comandă din afara domeniului răspunde scope_denied; o comandă pe o mașină doar în citire răspunde read_only.
login
konsolity login [--name <name>] [--scopes hosts,snippets,sessions,mcp] [--read-only]
Activează mașina cu un cod aprobat din contul dumneavoastră. Detalii și exemple: Activarea unei mașini.
setup-token
konsolity setup-token [--name <name>] [--scopes <list>] [--read-only]
Același flux ca login, dar afișează o singură dată un token ksetup_... în loc să salveze ceva. Furnizați-l apoi prin KONSOLITY_TOKEN. Vezi setup-token.
status
konsolity status [--json]
Afișează contul, numele și tipul mașinii, domeniul (domenii, doar în citire sau complet), expirarea, vechimea tokenului, starea serverului și numărul de gazde accesibile.
$ konsolity status
Account anthony@example.com
Machine build-01 (machine)
Scope hosts, snippets, mcp · full access
Expires on 2027-02-08
Token renewed 3 h ago
Server api.konsolity.com · reachable
Hosts 4
hosts
konsolity hosts [--json]
Listează gazdele din domeniu: etichetă, adresă, utilizator, grup. Niciodată o parolă sau o cheie.
$ konsolity hosts
web-01 203.0.113.10 deploy Production
web-02 203.0.113.11 deploy Production
db-01 10.0.0.5 admin Data
run
konsolity run <host> [--timeout <seconds>] [--json] -- <command>
Rulează o comandă pe o gazdă prin SSH: conexiune scurtă dedicată, cheie de gazdă fixată obligatorie, ieșire în timp real în terminal, codul de ieșire al comenzii la distanță transmis drept cod de ieșire al konsolity. <host> este eticheta gazdei sau identificatorul său. Tot ce urmează după -- este comanda, așa cum este.
| Opțiune | Rol |
|---|---|
--timeout <seconds> |
Timpul de execuție al comenzii, limitat de timpul maxim al mașinii (60 s implicit). |
--json |
O singură ieșire JSON la final: exit_code, stdout, stderr, duration_ms. |
$ konsolity run web-01 -- systemctl status nginx
● nginx.service - A high performance web server
Active: active (running) since Mon 2026-11-09 08:12:44 UTC
$ echo $?
0
Înainte de a rula comanda, CLI verifică domeniul și regulile, apoi scrie pornirea în jurnal: dacă această scriere eșuează, comanda nu este rulată. O comandă distructivă așteaptă confirmarea dumneavoastră:
$ konsolity run db-01 -- "mysql -e 'DROP TABLE sessions_old'"
Destructive command: confirmation requested in the Konsolity app.
https://app.konsolity.com/cli/confirm/9f3c2a71
Waiting (5 min at most)...
Allowed. Running.
snippet
konsolity snippet list [--json]
konsolity snippet run <snippet> <host> [--timeout <seconds>] [--json]
snippet list afișează fragmentele din domeniu (nume, grup). snippet run rulează un fragment, așa cum este salvat în seif, pe o gazdă din domeniu. <snippet> este numele sau identificatorul său. Se aplică aceleași reguli ca la run: jurnal, confirmare dacă conținutul este distructiv, cod de ieșire transmis.
$ konsolity snippet run "Clear the cache" web-01
Cache cleared.
sessions
konsolity sessions [--follow] [--json]
konsolity sessions end <id>
Listează sesiunile CLI în curs pe cont: mașină, comandă, de când. --follow menține lista deschisă și o reîmprospătează. sessions end <id> încheie o sesiune: comanda corespunzătoare este oprită în mai puțin de 5 secunde.
$ konsolity sessions
a1b2c3 build-01 run web-01: tail -f /var/log/nginx/access.log for 12 min
d4e5f6 laptop mcp for 1 h
$ konsolity sessions end a1b2c3
mcp
konsolity mcp
Pornește un server MCP local stdio, de conectat în Claude Code:
claude mcp add konsolity -- konsolity mcp
Detaliile instrumentelor și ale limitelor: MCP local pentru Claude Code.
serve
konsolity serve
Tratează cererile conectorului Claude al contului (claude.ai, aplicația Claude) așa cum o face aplicația desktop, dar fără interfață, în limitele domeniului și ale regulilor. Necesită domeniul mcp și integrarea Claude din planul Studio. Rămâne în prim-plan; pentru un server, instalați-o ca serviciu.
service install
sudo konsolity service install
Instalează konsolity serve ca serviciu de sistem (systemd, launchd sau o activitate programată Windows). Vezi Serviciu și stocare.
rotate
konsolity rotate
Forțează reînnoirea tokenului mașinii. Rotația este oricum automată la fiecare 24 de ore. Cheia de mașină nu se schimbă.
policy
konsolity policy [--json]
Afișează ce aplică efectiv mașina: domenii, doar în citire sau complet, gazde, fragmente, reguli de comenzi, „Orice comandă”, timp maxim de execuție.
logout
konsolity logout
Revocă mașina pe server, apoi șterge tokenul, cheia de mașină și copiile locale. Pentru a folosi din nou mașina, este necesară o nouă activare.
version
konsolity version
Afișează versiunea, sistemul și arhitectura.
update
konsolity update
Descarcă cea mai recentă versiune, îi verifică hash-ul SHA-256 și semnătura Ed25519 a manifestului, apoi înlocuiește binarul. Când a fost instalat cu apt, dnf sau Homebrew, CLI vă trimite la acel manager.
Variabile de mediu
| Variabilă | Rol |
|---|---|
KONSOLITY_TOKEN |
Token de lungă durată ksetup_... (CI, containere). Ține locul secretelor salvate. |
Coduri de ieșire
| Cod | Semnificație |
|---|---|
0 |
Succes. |
| cod la distanță | run și snippet run se încheie cu codul de ieșire al comenzii la distanță (de exemplu 1 dacă comanda a eșuat pe gazdă). |
1 |
Eroare generală: mașină neactivată, rețea inaccesibilă, gazdă sau snippet negăsit, linie de jurnal nescrisă (comanda nu este atunci pornită), secrete locale ilizibile. |
2 |
Eroare de utilizare: opțiune necunoscută, comandă lipsă sau prea lungă (cel mult 4.000 de caractere), KONSOLITY_TOKEN invalid. |
3 |
Refuz: în afara domeniului (scope_denied), mașină doar în citire (read_only), nicio regulă nu se potrivește (denied), reguli lipsă (policy_missing), abonament necesar (plan_required) sau activare refuzată. |
4 |
Comandă distructivă neconfirmată: refuzată în aplicație sau în consolă, ori fără răspuns în 5 minute. Nu a fost pornită. |
77 |
Mașină revocată, expirată sau folosită de pe alt computer (amprentă diferită), ori sesiune încheiată din aplicație sau din consolă: conexiunile sunt întrerupte și comanda oprită. Cu excepția unei simple încheieri de sesiune, secretele locale sunt și ele șterse. |