Kommandoreferanse
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. |