Kommandozeile
vaicoa-run akzeptiert --json bei jedem Befehl. Das Benutzerhandbuch (docs/handbuch.md) zeigt jeden Befehl mit
seiner erwarteten Ausgabe.
vcx und vaicoa-run
Abschnitt betitelt „vcx und vaicoa-run“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 tunnelvaicoa-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
Abschnitt betitelt „vaicoa-core“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):
| Befehl | Was er tut |
|---|---|
init [--profile starter|standard|strict] | Schlüssel, CA, Katalog, Policy und die Konfiguration anlegen |
init --quickstart --public-url URL | die Einrichtung in einem Schritt aus dem Schnellstart, Solo-Modus an |
serve | den Kern betreiben |
check | alles, was abgeschwächt, gelockert, fehlend oder ausstehend ist: Profil, Bereitschaft, Updates, MCP-Drift, Zugriffsprüfungen |
audit-verify | die 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 add | der Einzeiler zum Registrieren eines Node |
secret put --slot … --kind … | ein Credential in einen Slot versiegeln |
ipsec render|apply | die strongSwan-Konfiguration zwischen Kern und Nodes |
member-suspend, member-lift | ein Mitglied sperren (zum Beispiel, wenn der Identity Provider es deaktiviert hat) |
backup, backup verify, restore | das verschlüsselte Backup des Kerns |
report dora|toil|oncall|kpis|drill … | Berichte aus dem Audit |
updates status|import | der signierte Release-Feed |
usage report|casestudy|remind|reset-id | der freiwillige Nutzungsbericht und die Fallstudie (Feedback) |
demo | ein 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.