Overzicht van de opdrachten

Bijgewerkt op 10 november 2026

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.