Kommandoreferanse

Oppdatert 10. november 2026

Alle kommandoer skrives konsolity <command> [options]. konsolity help og konsolity <command> --help viser hjelpen på systemets språk. --json-utdata er stabile og beregnet på skript; de inneholder aldri hemmeligheter.

Oversikt

Kommando Påkrevd domene Funksjon
login Aktiver maskinen (Aktiver en maskin)
setup-token Opprett et langvarig token for CI og containere
status Konto, maskin, omfang, utløp, status
hosts hosts Verter i omfanget
run hosts, full tilgang Kjør en kommando på en vert
snippet list snippets Snutter i omfanget
snippet run snippets + hosts, full tilgang Kjør en snutt på en vert
sessions sessions CLI-økter som kjører på kontoen
sessions end sessions Avslutt en økt
mcp mcp Lokal MCP-server for Claude Code (Lokal MCP)
serve mcp + Claude-integrasjon Behandle forespørslene fra Claude-koblingen (Tjeneste)
service install Installer serve som systemtjeneste
rotate Forny maskinens token
policy Vis omfanget og reglene som brukes
logout Tilbakekall maskinen og slett alt lokalt
version Versjon, system, arkitektur
update Oppdater binærfilen (signaturen kontrolleres)

En kommando utenfor omfanget svarer scope_denied; en kommando på en skrivebeskyttet maskin svarer read_only.

login

konsolity login [--name <name>] [--scopes hosts,snippets,sessions,mcp] [--read-only]

Aktiverer maskinen med en kode godkjent fra kontoen din. Detaljer og eksempler: Aktiver en maskin.

setup-token

konsolity setup-token [--name <name>] [--scopes <list>] [--read-only]

Samme flyt som login, men viser én gang et ksetup_...-token i stedet for å lagre noe. Gi det deretter videre via KONSOLITY_TOKEN. Se setup-token.

status

konsolity status [--json]

Viser kontoen, maskinens navn og type, omfanget (domener, skrivebeskyttet eller full), utløpet, tokenets alder, serverstatusen og antall verter som kan nås.

$ 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]

Viser vertene i omfanget: etikett, adresse, bruker, gruppe. Aldri et passord eller en nøkkel.

$ 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>

Kjører en kommando på en vert over SSH: kort, egen tilkobling, festet vertsnøkkel påkrevd, utdata direkte i terminalen, avslutningskoden til den eksterne kommandoen videreføres som avslutningskoden til konsolity. <host> er vertens etikett eller identifikator. Alt etter -- er kommandoen, slik den er.

Alternativ Funksjon
--timeout <seconds> Tidsgrense for kommandoen, begrenset av maskinens maksimale tidsgrense (60 s som standard).
--json Ett enkelt JSON-utdata til slutt: 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

Før kommandoen kjøres, kontrollerer CLI-en omfanget og reglene, og skriver deretter starten i loggen: hvis denne skrivingen mislykkes, kjøres ikke kommandoen. En destruktiv kommando venter på din bekreftelse:

$ 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 viser snuttene i omfanget (navn, gruppe). snippet run kjører en snutt, slik den er lagret i hvelvet, på en vert i omfanget. <snippet> er navnet eller identifikatoren. De samme reglene som for run gjelder: logg, bekreftelse hvis innholdet er destruktivt, avslutningskoden videreføres.

$ konsolity snippet run "Clear the cache" web-01
Cache cleared.

sessions

konsolity sessions [--follow] [--json]
konsolity sessions end <id>

Viser CLI-øktene som kjører på kontoen: maskin, kommando, siden når. --follow holder listen åpen og oppdaterer den. sessions end <id> avslutter en økt: den tilhørende kommandoen stoppes på under 5 sekunder.

$ 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

Starter en lokal stdio-MCP-server som kobles til i Claude Code:

claude mcp add konsolity -- konsolity mcp

Detaljer om verktøyene og begrensningene: Lokal MCP for Claude Code.

serve

konsolity serve

Behandler forespørslene fra kontoens Claude-kobling (claude.ai, Claude-appen) slik skrivebordsappen gjør, men uten grensesnitt, innenfor omfanget og reglene. Krever domenet mcp og Claude-integrasjonen i Studio-planen. Kjører i forgrunnen; på en server installerer du den som tjeneste.

service install

sudo konsolity service install

Installerer konsolity serve som systemtjeneste (systemd, launchd eller en planlagt oppgave i Windows). Se Tjeneste og lagring.

rotate

konsolity rotate

Tvinger fornyelse av maskinens token. Rotasjonen skjer uansett automatisk hver 24. time. Maskinnøkkelen endres ikke.

policy

konsolity policy [--json]

Viser hva maskinen faktisk bruker: domener, skrivebeskyttet eller full, verter, snutter, kommandoregler, «Hvilken som helst kommando», maksimal tidsgrense.

logout

konsolity logout

Tilbakekaller maskinen på serveren, og sletter deretter tokenet, maskinnøkkelen og de lokale kopiene. For å bruke maskinen igjen kreves en ny aktivering.

version

konsolity version

Viser versjonen, systemet og arkitekturen.

update

konsolity update

Laster ned den nyeste versjonen, kontrollerer SHA-256-hashen og Ed25519-signaturen til manifestet, og erstatter deretter binærfilen. Når den er installert med apt, dnf eller Homebrew, henviser CLI-en deg til den pakkebehandleren.

Miljøvariabler

Variabel Funksjon
KONSOLITY_TOKEN Langvarig ksetup_...-token (CI, containere). Erstatter de lagrede hemmelighetene.

Avslutningskoder

Kode Betydning
0 Vellykket.
ekstern kode run og snippet run avslutter med avslutningskoden til den eksterne kommandoen (for eksempel 1 hvis kommandoen mislyktes på verten).
1 Generell feil: maskinen er ikke aktivert, nettverket kan ikke nås, vert eller snutt ble ikke funnet, logglinjen ble ikke skrevet (kommandoen startes da ikke), lokale hemmeligheter kan ikke leses.
2 Bruksfeil: ukjent valg, manglende eller for lang kommando (høyst 4 000 tegn), ugyldig KONSOLITY_TOKEN.
3 Avvist: domenet mangler i omfanget (scope_denied), maskin med kun lesetilgang (read_only), ingen regel passer (denied), regler mangler (policy_missing), abonnement kreves (plan_required) eller aktivering avvist.
4 Destruktiv kommando ikke bekreftet: avvist i appen eller konsollen, eller ikke besvart innen 5 minutter. Den ble ikke startet.
77 Maskinen er tilbakekalt, utløpt eller brukt fra en annen datamaskin (annet fingeravtrykk), eller økten er avsluttet fra appen eller konsollen: tilkoblingene brytes og kommandoen stoppes. Unntatt ved en vanlig avslutning av økten slettes også de lokale hemmelighetene.