Referința comenzilor

Actualizat pe 10 noiembrie 2026

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.