§ DOCUMENTATION

CLI-Referenz

Installieren Sie die Execlave-CLI, authentifizieren Sie sich mit einem API-Schlüssel und betreiben Sie Ihre Organisation vom Terminal aus. Liefert 11 Befehlsgruppen.

§ 01

Installation

npm install -g @execlave/cli

Installiert das execlave-Binary global. Erfordert Node.js 18+. Verifizieren mit:

execlave --version

§ 02

Schnellstart — mit einer Umgebungsvariable authentifizieren

Der schnellste, zuverlässigste Weg, die CLI zu authentifizieren, ist, Ihren API-Schlüssel als Umgebungsvariable zu exportieren. Die CLI prüft bei jedem Aufruf EXECLAVE_API_KEY und verwendet ihn direkt — kein Login-Schritt, keine Anmeldedaten auf der Festplatte.

# 1. API-Schlüssel im Dashboard erstellen → Einstellungen → API-Schlüsselexport EXECLAVE_API_KEY="exe_prod_..."export EXECLAVE_BASE_URL="https://api.execlave.com"   # optional, dies ist der Standard # 2. Verbindung und Schlüssel verifizierenexeclave status # 3. Beliebigen Lesebefehl ausführen, um die Autorisierung zu bestätigenexeclave agents list

Unter Windows PowerShell verwenden Sie $env:EXECLAVE_API_KEY = "exe_prod_...".

§ 03

Befehle der obersten Ebene

11 Befehlsgruppen. Führen Sie jeden Befehl mit --help aus, um vollständige Details zu den Unterbefehlen zu erhalten.

Befehl	Beschreibung
`login`	Speichert interaktiv einen API-Schlüssel + Basis-URL in der lokalen Konfigurationsdatei.
`status`	Prüft die Backend-Gesundheit und verifiziert den aktiven API-Schlüssel.
`bootstrap`	Interaktiver Einrichtungsassistent für eine neue Execlave-Umgebung.
`agents`	KI-Agenten auflisten, pausieren (Kill-Switch) und fortsetzen.
`org`	Zeigt Infos und Einstellungen der aktuellen Organisation an.
`workspace`	Workspaces auflisten und erstellen.
`prompts`	Prompt-Versionen auflisten, bereitstellen, zurückrollen und freigeben.
`traces`	Aktuelle Ausführungs-Traces auflisten und 24-Stunden-Statistiken anzeigen.
`policies`	Governance-Richtlinien und -Verstöße auflisten, anwenden, testen und inspizieren.
`incidents`	Richtlinienverstoß-Vorfälle auflisten und exportieren (CSV/JSON).
`validators`	Benutzerdefinierte HTTP-Validatoren verwalten (Bring-Your-Own-Validator).

§ 04

Häufige Anwendungsbeispiele

§ Umgebung inspizieren

execlave status                    # Gesundheits- + Auth-Prüfungexeclave org list                  # aktuelle Organisationexeclave workspace list            # Workspaces in dieser Org

§ Agenten & Traces

execlave agents listexeclave agents pause <agent-id> --reason "Untersuche ausufernde Kosten"execlave agents resume <agent-id> execlave traces list --agent-id <agent-id>execlave traces stats              # rollierende 24-Stunden-Zusammenfassung

§ Richtlinien

execlave policies listexeclave policies violationsexeclave policies apply --file ./policies.yamlexeclave policies test  --file ./policies.yaml --from 7dexeclave policies chain --id <policy-id>

§ Prompt-Versionen

execlave prompts list --agent-id <agent-id>execlave prompts deploy   <version-id> --env stagingexeclave prompts approve  <version-id>execlave prompts rollback <version-id> --reason "Regression in der Eval-Suite"

§ Vorfälle & Validatoren

execlave incidents listexeclave incidents export --format csv --from 30d execlave validators listexeclave validators create \  --name "PII Scrubber" \  --url https://validator.example.com/check \  --fail-mode fail_closedexeclave validators test <validator-id>execlave validators rotate-secret <validator-id>

§ API-Versions-Override (pro Aufruf)

execlave --api-version v1 agents list   # Standardexeclave --api-version v0 agents list   # Legacy, unversionierte Routen

§ 05

Authentifizierungs-Rangfolge

Bei jedem Aufruf ermittelt die CLI den API-Schlüssel, indem sie drei Quellen der Reihe nach durchläuft und die erste gefundene verwendet. Es gibt absichtlich kein --api-key-Flag — übergeben Sie Schlüssel über Umgebungsvariablen oder die Konfigurationsdatei.

#	Quelle	Hinweise
1	`EXECLAVE_API_KEY`	Höchste Rangfolge. Empfohlen für CI und Ad-hoc-Shells.
2	`AGENTGUARD_API_KEY`	Veralteter Alias. Funktioniert noch; gibt einmal pro Prozess eine Veraltungs-Warnung aus.
3	Konfigurationsdatei (`token`)	Von execlave login geschrieben. Über Sitzungen hinweg persistiert.

Die Basis-URL folgt derselben Rangfolge: EXECLAVE_BASE_URL > AGENTGUARD_BASE_URL > Konfig baseUrl > https://api.execlave.com.

§ 06

Speicherort der Konfigurationsdatei

Die CLI verwendet das conf-Paket mit dem Projektnamen execlave-cli. Das Schema lautet { token, baseUrl, organizationId, apiVersion }. Beim ersten Schreiben wird die Datei auf den aktuellen Benutzer beschränkt (chmod 0600 unter POSIX, icacls-ACL unter Windows).

Plattform	Pfad
macOS	`~/Library/Preferences/execlave-cli-nodejs/config.json`
Linux	`~/.config/execlave-cli-nodejs/config.json`
Windows	`%APPDATA%\execlave-cli-nodejs\config.json`

Löschen Sie diese Datei, um sich vollständig abzumelden, oder setzen Sie EXECLAVE_API_KEY in Ihrer Shell auf eine leere Zeichenkette, um sie für die aktuelle Sitzung zu überschreiben.