Zum Inhalt springen
Ein persönliches Experiment · Alpha · Code noch nicht öffentlich · kein Angebot, kein Support Projektstatus →

Kommandozeile

vaicoa-run akzeptiert --json bei jedem Befehl. Das Benutzerhandbuch (docs/handbuch.md) zeigt jeden Befehl mit seiner erwarteten Ausgabe.

vcx ist die Kommandozeile für Menschen: ein Gerät koppeln, vorschlagen, freigeben oder ablehnen, Roster und Kataloge signieren, das Audit lesen und exportieren, Tunnel öffnen. vaicoa-run ist der Client in einer Agent-Session: das Ticket der Session einlösen, die erlaubten Aktionen auflisten, erklären, vorschlagen, warten, berichten oder all das als lokalen MCP-Server bereitstellen (vaicoa-run mcp).

Generated on 2026-11-07 from vaicoa-core 0f756db.

usage: vcx <command> [flags]
access-review Access reviews: vcx access-review list | show <id> | confirm <id> [--except kind:id,...] | lapse <id> [--out draft.json] (owners)
approvals List pending approvals
approve Approve a pending approval after reviewing it: vcx approve <id>
audit Show and verify the audit log; audit export --from --to [--out f]; audit verify-export f
catalog Sign a catalog YAML with a release key: vcx catalog sign --key ref [--out env.json] file.yaml; an internal layer with an owner's device: vcx catalog sign --layer org.<name> [--countersign env.json] [--pin-draft draft.json] file.yaml; draft a layer from an MCP server: vcx catalog import-mcp --server <command…|url> --layer org.<name> --provider <p> --out DIR
deny Deny a pending approval: vcx deny <id>
device Devices: vcx device list [--mine] | suspend <keyId> --reason lost|stolen|compromised|not-mine|other [--note t] [--yes] | lift <keyId>
emergency Emergency changes: vcx emergency list [--all]; vcx emergency review <opId> [--concern] [--note …] (owners)
image Resolve an image tag to a digest-pinned reference: vcx image digest docker.io/library/nginx:1.27-alpine
incidents List incidents: vcx incidents [--state open|closed]
key Create, show or delete a device key: vcx key new|show|delete [--key file:…|pkcs11:…|se:…] [--curve p256|p384] [--se-access presence|biometry|password]
keys Alias of vcx key
member Members: vcx member suspend <memberId> --reason idp-disabled|left|compromised|other [--note t] [--yes] | lift <memberId>
op Show an op's state, steps and result: vcx op <id>; end an unknown op (owner): vcx op resolve <id> --outcome done|failed|voided --reason …
ops List ops: vcx ops [--env E] [--state S]
pair Pair this device with a core: vcx pair --code … --member … --ca-fingerprint sha256:… <core-url>
propose Propose an action: vcx propose <action> --env E --param k=v
report Print a stored report (e.g. a postmortem): vcx report <reportId>
roster Sign or push the roster: vcx roster sign [--in draft.json|draft.json|--countersign env.json] [--push]; vcx roster push env.json; vcx roster draft [--from-core|--from env.json] [--out draft.json]: the next serial of the roster this device verified
run Agent session runs: vcx run end <runId> [--reason …] (the member the run acts for, or an owner)
sign vcx sign roster|catalog|trigger … (same as vcx roster sign, vcx catalog sign, vcx trigger sign)
slo Show the error budgets: vcx slo
status Show this device's standing and the roster's expiry: vcx status
trigger Sign a trigger YAML (release key or owner device): vcx trigger sign --key ref file.yaml
trust Pin what vcx trusts: vcx trust release-key <pub.pem> [--replace] | vcx trust list
tunnel Forward a local port to a node service over the TLS tunnel
vaicoa-run: usage: vaicoa-run <redeem|pair|task|actions|explain|propose|status|wait|report|review-next|review-decide|mcp|version> [flags]

vaicoa-run-Exit-Codes: 0 in Ordnung (auch pending_approval und needs_approval), 1 Fehler, 2 falsche Verwendung, 3 abgelehnt, 4 fehlgeschlagen, 5 Zeitüberschreitung bei wait.

vaicoa-core läuft auf dem Host des Kerns. Es gibt keine Befehlsliste aus; das sind die Befehle, die es akzeptiert (die meisten nehmen --config core.yaml oder lesen VAICOA_CORE_CONFIG):

BefehlWas er tut
init [--profile starter|standard|strict]Schlüssel, CA, Katalog, Policy und die Konfiguration anlegen
init --quickstart --public-url URLdie Einrichtung in einem Schritt aus dem Schnellstart, Solo-Modus an
serveden Kern betreiben
checkalles, was abgeschwächt, gelockert, fehlend oder ausstehend ist: Profil, Bereitschaft, Updates, MCP-Drift, Zugriffsprüfungen
audit-verifydie Audit-Kette im Speicher des Kerns prüfen
pairing-code [--mobile --qr]ein Kopplungscode oder QR-Code für ein neues Gerät
join-token --environment E [--node N]ein Einmal-Token zur Registrierung eines Node
node addder Einzeiler zum Registrieren eines Node
secret put --slot … --kind …ein Credential in einen Slot versiegeln
ipsec render|applydie strongSwan-Konfiguration zwischen Kern und Nodes
member-suspend, member-liftein Mitglied sperren (zum Beispiel, wenn der Identity Provider es deaktiviert hat)
backup, backup verify, restoredas verschlüsselte Backup des Kerns
report dora|toil|oncall|kpis|drill …Berichte aus dem Audit
updates status|importder signierte Release-Feed
usage report|casestudy|remind|reset-idder freiwillige Nutzungsbericht und die Fallstudie (Feedback)
demoein Demo-Modus mit Beispieldaten

vaicoa-node läuft als Dienst auf jedem Host und liest /etc/vaicoa/node.yaml; es hat keine Unterbefehle für Betreiber.