Overzicht van de opdrachten
Elke opdracht wordt geschreven als konsolity <command> [options]. konsolity help en konsolity <command> --help tonen de hulp in de taal van het systeem. De --json-uitvoer is stabiel en bedoeld voor scripts; ze bevat nooit een geheim.
Overzicht
| Opdracht | Vereist domein | Functie |
|---|---|---|
login |
De machine activeren (Een machine activeren) | |
setup-token |
Een langlevend token aanmaken voor CI en containers | |
status |
Account, machine, bereik, vervaldatum, status | |
hosts |
hosts |
Hosts binnen het bereik |
run |
hosts, volledige toegang |
Een opdracht uitvoeren op een host |
snippet list |
snippets |
Snippets binnen het bereik |
snippet run |
snippets + hosts, volledige toegang |
Een snippet uitvoeren op een host |
sessions |
sessions |
CLI-sessies die op het account lopen |
sessions end |
sessions |
Een sessie beëindigen |
mcp |
mcp |
Lokale MCP-server voor Claude Code (Lokale MCP) |
serve |
mcp + Claude-integratie |
De verzoeken van de Claude-connector afhandelen (Service) |
service install |
serve installeren als systeemservice |
|
rotate |
Het token van de machine vernieuwen | |
policy |
Het toegepaste bereik en de regels tonen | |
logout |
De machine intrekken en lokaal alles wissen | |
version |
Versie, systeem, architectuur | |
update |
Het binaire bestand bijwerken (handtekening gecontroleerd) |
Een opdracht buiten het bereik antwoordt met scope_denied; een opdracht op een machine met alleen-lezentoegang antwoordt met read_only.
login
konsolity login [--name <name>] [--scopes hosts,snippets,sessions,mcp] [--read-only]
Activeert de machine met een code die je vanuit je account goedkeurt. Details en voorbeelden: Een machine activeren.
setup-token
konsolity setup-token [--name <name>] [--scopes <list>] [--read-only]
Hetzelfde verloop als login, maar toont één keer een token ksetup_... in plaats van iets op te slaan. Geef het daarna door via KONSOLITY_TOKEN. Zie setup-token.
status
konsolity status [--json]
Toont het account, de naam en het type van de machine, het bereik (domeinen, alleen lezen of volledig), de vervaldatum, de leeftijd van het token, de status van de server en het aantal bereikbare hosts.
$ 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]
Toont de hosts binnen het bereik: label, adres, gebruiker, groep. Nooit een wachtwoord of een sleutel.
$ 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>
Voert een opdracht uit op een host via SSH: korte, speciale verbinding, vastgelegde hostsleutel vereist, live uitvoer in de terminal, afsluitcode van de externe opdracht doorgegeven als afsluitcode van konsolity. <host> is het label van de host of de identificatie ervan. Alles na -- is de opdracht, zoals ze is.
| Optie | Functie |
|---|---|
--timeout <seconds> |
Time-out van de opdracht, begrensd door de maximale time-out van de machine (standaard 60 s). |
--json |
Eén enkele JSON-uitvoer aan het eind: 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
Voordat de opdracht wordt uitgevoerd, controleert de CLI het bereik en de regels en schrijft daarna de start in het logboek: als dat schrijven mislukt, wordt de opdracht niet uitgevoerd. Een destructieve opdracht wacht op je bevestiging:
$ 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 toont de snippets binnen het bereik (naam, groep). snippet run voert een snippet uit, zoals het in de kluis is opgeslagen, op een host binnen het bereik. <snippet> is de naam of de identificatie ervan. Dezelfde regels als bij run gelden: logboek, bevestiging als de inhoud destructief is, afsluitcode doorgegeven.
$ konsolity snippet run "Clear the cache" web-01
Cache cleared.
sessions
konsolity sessions [--follow] [--json]
konsolity sessions end <id>
Toont de CLI-sessies die op het account lopen: machine, opdracht, sinds wanneer. --follow houdt de lijst open en ververst haar. sessions end <id> beëindigt een sessie: de bijbehorende opdracht wordt binnen 5 seconden gestopt.
$ 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
Start een lokale stdio-MCP-server, om te koppelen in Claude Code:
claude mcp add konsolity -- konsolity mcp
Details van de tools en de limieten: Lokale MCP voor Claude Code.
serve
konsolity serve
Handelt de verzoeken van de Claude-connector van het account af (claude.ai, Claude-app) zoals de desktop-app dat doet, maar zonder interface, binnen het bereik en de regels. Vereist het domein mcp en de Claude-integratie van het abonnement Studio. Blijft op de voorgrond draaien; installeer het op een server als service.
service install
sudo konsolity service install
Installeert konsolity serve als systeemservice (systemd, launchd of een geplande taak in Windows). Zie Service en opslag.
rotate
konsolity rotate
Dwingt het vernieuwen van het token van de machine af. De rotatie gebeurt sowieso automatisch elke 24 uur. De machinesleutel verandert niet.
policy
konsolity policy [--json]
Toont wat de machine werkelijk toepast: domeinen, alleen lezen of volledig, hosts, snippets, regels voor opdrachten, "Elke opdracht", maximale time-out.
logout
konsolity logout
Trekt de machine in op de server en wist daarna het token, de machinesleutel en de lokale kopieën. Om de machine opnieuw te gebruiken, is een nieuwe activering nodig.
version
konsolity version
Toont de versie, het systeem en de architectuur.
update
konsolity update
Downloadt de nieuwste versie, controleert de SHA-256-hash ervan en de Ed25519-handtekening van het manifest en vervangt daarna het binaire bestand. Bij installatie met apt, dnf of Homebrew verwijst de CLI je naar die pakketbeheerder.
Omgevingsvariabelen
| Variabele | Functie |
|---|---|
KONSOLITY_TOKEN |
Langlevend token ksetup_... (CI, containers). Vervangt de opgeslagen geheimen. |
Afsluitcodes
| Code | Betekenis |
|---|---|
0 |
Gelukt. |
| externe code | run en snippet run sluiten af met de afsluitcode van de externe opdracht (bijvoorbeeld 1 als de opdracht op de host is mislukt). |
1 |
Algemene fout: machine niet geactiveerd, netwerk onbereikbaar, host of snippet niet gevonden, logregel niet geschreven (de opdracht wordt dan niet gestart), lokale geheimen onleesbaar. |
2 |
Gebruiksfout: onbekende optie, ontbrekende of te lange opdracht (hoogstens 4.000 tekens), ongeldige KONSOLITY_TOKEN. |
3 |
Geweigerd: domein ontbreekt in het bereik (scope_denied), machine met alleen-lezen (read_only), geen regel komt overeen (denied), regels ontbreken (policy_missing), abonnement vereist (plan_required) of activering geweigerd. |
4 |
Destructieve opdracht niet bevestigd: geweigerd in de app of de console, of geen antwoord binnen 5 minuten. Ze is niet gestart. |
77 |
Machine ingetrokken, verlopen of gebruikt vanaf een andere computer (andere vingerafdruk), of sessie beëindigd vanuit de app of de console: verbindingen worden verbroken en de opdracht gestopt. Behalve bij een gewoon einde van de sessie worden ook de lokale geheimen gewist. |