CLI-Befehlsreferenz

Vollständige Referenz aller Befehle von @zeuslock/cli (v0.1.x). Für Installation und erste Anmeldung beginnen Sie mit dem CLI-Schnellstart. Jeder datenliefernde Befehl unterstützt --json für Skripte, und --help funktioniert bei jedem Befehl und Unterbefehl.

Befehlsübersicht

Anmeldedaten und Konfiguration

Die CLI verwendet bewusst zwei verschiedene Anmeldedaten. Benutzer-Anmeldedaten (Login-Sitzung oder persönliches CLI-Zugriffstoken von der Dashboard-CLI-Seite) steuern die Dashboard-Datenbefehle. Der Organisations-API-Schlüssel (zl_…, Seite API-Schlüssel) steuert die Inhalts- und SIEM-Befehle, die für die Organisation handeln.

Umgebungsvariablen

Das Konfigurationsverzeichnis (macOS ~/Library/Application Support/zeuslock/, Windows %APPDATA%\ZeusLock\, Linux ~/.config/zeuslock/) enthält auth.json (Sitzungstoken, 0600), api-key.json (Organisationsschlüssel) und siem-cursors.json (Tail-Cursor). Passwörter werden nie gespeichert, und die CLI gibt gespeicherte Geheimnisse nie aus.

zeuslock auth

zeuslock auth login --email admin@example.com
zeuslock whoami
zeuslock auth api-key set zl_your_org_api_key
zeuslock auth api-key status

auth login

auth api-key set / status / clear

set validiert den Schlüssel über GET /api/rules/sync vor dem Speichern; status zeigt den Zustand mit maskiertem Schlüssel; clear entfernt ihn. Der vollständige Schlüssel wird nie erneut ausgegeben.

Schlüssel-Priorität für Maschinenbefehle: Option --api-key → ZEUSLOCK_API_KEY → gespeicherter Schlüssel.

zeuslock status

zeuslock status
zeuslock status --api-key zl_your_key_here --require-license
zeuslock status --json

zeuslock scan

zeuslock scan ./secrets.txt
zeuslock scan ./src --fail-on alert
cat prompt.txt | zeuslock scan --stdin --json

Lädt Inhalte an POST /api/v1/dlp/analyze unter der aktiven DLP-Richtlinie der Organisation hoch. Verzeichnisse werden rekursiv durchlaufen (.git übersprungen) und in 5er-Stapeln hochgeladen. Ein Scan mit alert/block erzeugt einen echten Vorfall — es gibt keinen Probelauf.

zeuslock anonymize

zeuslock anonymize customer-data.txt --output customer-data.safe.txt

Sendet UTF-8-Text an POST /api/v1/anonymize und liefert den maskierten Text. Nur Text — PDF/Bilder/Office werden vom Endpoint nicht unterstützt.

zeuslock hook install / run

zeuslock hook install --fail-on alert
zeuslock hook run --json

install schreibt .git/hooks/pre-commit (0755, --force zum Ersetzen eines vorhandenen Hooks); run scannt gestagte Blobs genau so, wie sie committet werden (nur hinzugefügte/kopierte/geänderte/umbenannte Dateien) über denselben DLP-Endpoint und blockiert den Commit an der gewählten Schwelle. Hook-Vorfälle tragen source=git_pre_commit, platform=git, method=PRE_COMMIT. install --fail-on never wird abgelehnt.

zeuslock incidents list / stats / export

zeuslock incidents list --days 7 --severity critical
zeuslock incidents stats --days 30
zeuslock incidents export --days 30 --format csv --output incidents.csv

zeuslock agents / extensions

zeuslock agents list --status offline --search linux
zeuslock agents revoke AGENT-123 --yes
zeuslock extensions status --json

zeuslock users / keys

zeuslock users list --role admin
zeuslock users remove departing@example.com --yes
zeuslock keys list --status active
zeuslock keys create --name rotation-2026-08
zeuslock keys revoke <key_id> --yes

zeuslock shadow-ai / mcp

zeuslock shadow-ai stats --days 30
zeuslock shadow-ai tools --source endpoint --status shadow
zeuslock shadow-ai users --days 7
zeuslock mcp stats
zeuslock mcp events --transport stdio --decision block --method tools/call
zeuslock mcp servers

Beide Gruppen folgen den Dashboard-Feature-Gates über GET /api/org: Shadow AI erfordert settings.shadow_ai_enabled; MCP ist aktiv, außer settings.mcp_enabled ist explizit false. MCP-Ereignisse sind nur bereinigte Metadaten — nie rohe Prompts.

zeuslock siem pull / tail

zeuslock siem pull --api-key zl_your_key_here --severity high --limit 100
zeuslock siem tail --category dlp --interval 10 --cursor-name splunk-prod

Ruft OCSF-Ereignisse über GET /api/v1/siem/events ab (Organisations-API-Schlüssel). pull liest eine Seite; tail fragt fortlaufend ab und speichert seinen Cursor in siem-cursors.json, indiziert nach API-URL, Cursor-Name, Kategorie und Schweregrad — getrennte Konsumenten können unabhängig folgen. Ausgabe standardmäßig JSONL, ideal für SIEM-Ingestion.

zeuslock deploy gpo-config / agent-verify

zeuslock deploy gpo-config --api-key zl_your_key_here --output zeuslock-deploy
zeuslock deploy gpo-config --artifact agent --create-key-name fleet-deploy
zeuslock deploy agent-verify --hostname CLIENT01 --status online

gpo-config erzeugt lokale Deployment-Dateien: Chrome/Edge-Force-Install-Richtlinien und ExtensionSettings-JSON, die Windows-Agent-Richtlinie .reg (ServerUrl/LicenseKey unter HKLM\SOFTWARE\Policies\ZeusLock), eine agent-config.json und eine geheimnislose deployment-summary.json. Extension-Artefakte erfordern den Business/Enterprise-Plan. Schlüssel-Priorität: --api-key → --create-key-name → --key-id → der einzige aktive entschlüsselbare Schlüssel. agent-verify prüft Enrollment/Heartbeat über GET /api/agents und beendet mit Fehlercode, wenn nicht verifiziert — nützlich nach einem GPO-Rollout.

zeuslock rules get / diff

zeuslock rules get --output zeuslock.rules.yaml
zeuslock rules get --scope policy --policy-id default --format json
zeuslock rules diff zeuslock.rules.yaml

Nur-Lese-Policy-as-Code: get exportiert den Live-Zustand als deterministisches YAML/JSON (schema_version: zeuslock.rules.v1, volatile Felder entfernt für saubere Diffs); diff vergleicht eine lokale Datei mit dem Live-Zustand und beendet mit Code 1 bei Abweichungen — ideal für Drift-Checks in CI. Kein Import/Apply: Richtlinien werden im Dashboard geändert.

Exit-Codes