Level CLI, oder lvl, ermöglicht es Ihnen, mit Ihrem Level-Konto über ein Terminal zu arbeiten. Sie können Geräte, Aktualisierungen, Dateien, Monitore, Warnmeldungen, Skripte, Automatisierungen und den Ausführungsverlauf einsehen, ohne zur Level-Web-App wechseln zu müssen.
Sie können auch die Level-Skill für einen Coding-Agenten installieren. Die Skill bringt unterstützten Agenten bei, wie die Befehle und die JSON-Ausgabe Ihrer installierten Version von lvl. Sie stellen den Coding-Agenten, das Modell und die Token bereit.
ℹ️ HINWEIS: Die lvl CLI verwaltet Ihr Level-Konto. Er ist vom Level-Agenten getrennt, der auf verwalteten Geräten installiert ist.
Bevor Sie beginnen
Sie benötigen:
Ein Level-Konto mit aktiviertem CLI-Zugriff für Ihre Rolle unter Arbeitsbereich → Berechtigungen. Administratoren haben immer CLI-Zugriff.
Einen unterstützten Computer mit Windows, macOS oder Linux auf einem AMD64- oder ARM64-Prozessor.
Einen Browser, mit dem Sie die CLI-Anmeldung bestätigen können.
ℹ️ HINWEIS: Wenn der CLI-Zugriff für Ihre Rolle deaktiviert ist, werden neue Anmeldungen und Sitzungsaktualisierungen mit Your role does not allow CLI access. Ein bereits ausgestelltes Zugriffstoken kann bis zu seinem Ablauf gültig bleiben, für bis zu einer Stunde.
ℹ️ HINWEIS: Wenn der CLI-Zugriff für Ihre Rolle aktiviert ist, öffnen Sie Einstellungen → CLI zum Kopieren von Installations-, Anmelde-, Hilfe- und Skill-Installationsbefehlen. Wenn der CLI-Zugriff für Ihre Rolle deaktiviert ist, ist diese Seite ausgeblendet und gibt „Zugriff verweigert" zurück. Siehe Arbeitsbereich-Berechtigungen. Um eine aktive CLI-Sitzung über die Web-App zu beenden, verwenden Sie Einstellungen → Sitzungen. Siehe Sitzungen.
Wenn Sie lvl mit einem Coding-Agenten verwenden möchten, installieren Sie diesen Agenten separat. Level hostet das Modell nicht und stellt keine Token bereit.
CLI installieren
Öffnen Sie Einstellungen → CLI und kopieren Sie den Installationsbefehl für Ihr Betriebssystem (macOS / Linux oder Windows PowerShell). Führen Sie diesen Befehl auf Ihrem Computer aus.
Unter macOS oder Linux wird damit lvl nach ~/.local/bin/lvl. Wenn dieses Verzeichnis noch nicht in Ihrem PATH, fügt das Installationsprogramm es zur Startdatei Ihrer Shell hinzu. Starten Sie Ihre Shell neu oder folgen Sie dem vom Installationsprogramm ausgegebenen Befehl, bevor Sie fortfahren.
Unter Windows wird damit lvl.exe nach %LOCALAPPDATA%\Programs\lvl und fügt dieses Verzeichnis zu Ihrem Benutzer- PATH. Öffnen Sie ein neues Terminal, wenn Ihr aktuelles Terminal lvl nach der Installation.
Das Installationsprogramm erkennt Ihre Prozessorarchitektur und verifiziert das heruntergeladene Archiv und die ausführbare Datei anhand der veröffentlichten SHA-256-Werte.
Bestätigen Sie, dass die CLI verfügbar ist:
lvl --help
Anmelden
Führen Sie aus:
lvl auth login
Die CLI gibt einen Einmalcode und eine Verifizierungs-URL aus und versucht dann, die URL in Ihrem Browser zu öffnen.
Melden Sie sich bei Level im Browser an. Ihre normalen SSO- und MFA-Anforderungen gelten weiterhin.
Bestätigen Sie, dass der Browser denselben Einmalcode wie Ihr Terminal anzeigt.
Zugriff genehmigen.
Kehren Sie zum Terminal zurück. Die CLI erkennt die Genehmigung und schließt die Anmeldung ab.
Wenn der Browser sich nicht öffnet, kopieren Sie die ausgegebene URL in einen Browser auf einem beliebigen Computer.
Aktive Sitzung überprüfen:
lvl auth status
Abmelden und die lokale Sitzung entfernen:
lvl auth logout
CLI aktuell halten
Standardmäßig lvl sucht im Hintergrund nach einer neueren Version, wenn Sie einen Befehl ausführen, höchstens einmal pro Stunde. Wenn eine Aktualisierung verfügbar ist, installiert Ihr nächster Befehl diese und setzt auf der neuen Version fort.
Sofort nach einer Aktualisierung suchen und diese installieren:
lvl self-update
Erste Befehle ausführen
Geräte auflisten:
lvl device list
Verfügbare Software-Aktualisierungen auflisten:
lvl update list
Repository-Dateien auflisten:
lvl file list
Monitore und Monitor-Richtlinien auflisten:
lvl monitor list
lvl monitor policy list
Aktive Warnmeldungen auflisten:
lvl alert list
Verwenden Sie nach Möglichkeit eine Geräte-ID. Sie können ein Gerät auch über Hostname, Name, Spitzname oder einen gruppenqualifizierten Hostnamen wie Servers/web-01. Wenn ein Name mehr als einen Datensatz trifft, lvl hält an und fordert stattdessen eine genauere Angabe an.
Ausgabeformat wählen
Die meisten Befehle zeigen standardmäßig eine Tabelle an. Verwenden Sie JSON, wenn ein anderes Programm das Ergebnis lesen muss:
lvl device list -o json
Verwenden Sie den integrierten jq-Filter, um einen Teil des JSON-Ergebnisses auszuwählen:
lvl device list --jq '.list[].name'
Listenbefehl geben standardmäßig bis zu 100 Ergebnisse zurück. Verwenden Sie --limit um die Anzahl zu ändern, oder alle Seiten abrufen:
lvl device list --limit 250
lvl device list --limit all
Exportieren Sie unterstützte Ressourcen als CSV, indem Sie die Standardausgabe in eine Datei umleiten:
lvl device export > devices.csv
lvl alert export --status resolved > resolved-alerts.csv
lvl run export --status error > failed-runs.csv
⚠️ WARNUNG: Die JSON-Ausgabe von API-Schlüsselbefehlen kann das vollständige Token enthalten. Schützen Sie exportierte Daten und CI-Protokolle und übergeben Sie keine Zugangsdaten an die Versionsverwaltung.
Skripte ausführen
Ein gespeichertes Skript auf einem Gerät ausführen:
lvl script run "Check disk space" --device web-01 --wait
Einen Befehl ausführen, ohne zuerst ein Skript zu speichern:
lvl script run --device web-01 --command 'hostname' --wait
Sie können mehr als ein Gerät mit wiederholten --device Flags oder eine Gerätegruppe mit --group.
Ohne --wait, gibt der Befehl die neuen Ausführungs-IDs zurück, nachdem Level die Anfrage angenommen hat. Verwenden Sie die Ausführungsbefehle, um Fortschritt und Ergebnisse zu prüfen:
lvl run list
lvl run get <run-id> --wait
Einzelheiten zu gespeicherten Skripten, Shells, Timeouts, Variablen, Ausgabe und Exit-Codes finden Sie unter Übersicht Skripting.
Automatisierungen als Spezifikationen verwalten
Eine Automatisierung als YAML exportieren:
lvl automation spec "Patch Servers" --format yaml > patch-servers.yaml
Änderungen vor dem Anwenden der Datei in der Vorschau prüfen:
lvl automation apply -f patch-servers.yaml --dry-run
Die Spezifikation anwenden:
lvl automation apply -f patch-servers.yaml
Die Datei beschreibt den Automatisierungsnamen, Auslöser, Aktionen und Variablen. Sie können die Datei in der Versionsverwaltung aufbewahren, einen Diff prüfen und sie nach Änderungen erneut anwenden.
⚠️ WARNUNG: Das Anwenden einer Automatisierungsspezifikation gleicht die aktive Automatisierung mit der Datei ab. Bestehende Auslöser oder Aktionen, die in der Datei fehlen, können gelöscht werden. Änderungen werden sequenziell angewendet, nicht als eine Transaktion; daher kann ein Fehler frühere Änderungen bestehen lassen. Führen Sie immer --dry-run, den Plan prüfen und einen aktuellen Export aufbewahren, bevor Sie Änderungen anwenden.
Automatisierungsspezifikationen verweisen auf Kontoressourcen wie Skripte, Gruppen, Tags, Dateien und benutzerdefinierte Felder anhand der ID. Behandeln Sie eine exportierte Spezifikation als Momentaufnahme für dasselbe Level-Konto.
Zu Automatisierungskonzepten und dem Web-Editor siehe Übersicht Automatisierungen und Automatisierungen erstellen.
lvl mit einem Coding-Agenten verwenden
Die von Ihrer aktuellen lvl Version:
lvl skill install
Der Befehl installiert eine SKILL.md Datei, in der unterstützte Coding-Agenten sie entdecken können. Beispiele umfassen Cursor, Claude Code, Codex, Gemini, Hermes und OpenClaw.
Nach der Installation können Sie Ihren Coding-Agenten bitten, Ihre Geräteflotte über lvl, ein Skript entwerfen oder eine Automatisierungsspezifikation entwerfen. Prüfen Sie jeden vorgeschlagenen Befehl und jede Datei, bevor Sie diese ausführen oder anwenden.
Die Standard-Benutzer-Skill wird automatisch aktualisiert, wenn Sie lvl Befehle, auch nach einem CLI-Upgrade. Sie müssen sie nach einem Upgrade nicht neu installieren.
Die generierte Skill anzeigen, ohne sie zu installieren:
lvl skill show
Die aktuellen Flags und die JSON-Ausgabestruktur eines Befehls einsehen:
lvl skill describe device list
lvl skill describe automation action add
ℹ️ HINWEIS: Das Installieren der Skill installiert keinen Coding-Agenten und verbindet Level nicht mit einem LLM-Anbieter. Sie wählen und konfigurieren den Coding-Agenten, das Modell und die Token selbst.
Änderungen bestätigen und Abschluss prüfen
Befehle, die Ressourcen dauerhaft löschen, unterstützen --yes. In einem interaktiven Terminal lvl vor diesen Änderungen auffordert. In einer nicht-interaktiven Sitzung, z. B. CI, schlagen Befehle, die eine Bestätigung erfordern, fehl, sofern Sie nicht --yes.
Einige Befehle fordern asynchrone Arbeit an und kehren zurück, bevor das Gerät sie abgeschlossen hat. Dazu gehören Neustart, Herunterfahren, Aktualisierungsprüfungen, Aktualisierungsinstallation, Skripte und Automatisierungen. Verwenden Sie lvl run get <run-id> --wait, den Ausführungsverlauf, Aktualisierungsprotokolle oder die Level-Web-App, um das endgültige Ergebnis zu bestätigen.
⚠️ WARNUNG: Behandeln Sie Installationsschlüssel, API-Token, exportierte Inventare, Skriptausgaben und Automatisierungsdateien als vertraulich. Vermeiden Sie es, diese in gemeinsam genutzten Terminals oder CI-Protokollen auszugeben.
Befehlshilfe aufrufen
Die oberste Befehlsliste anzeigen:
lvl --help
Hilfe für eine Befehlsgruppe oder einen Befehl anzeigen:
lvl device --help
lvl script run --help
lvl automation apply --help
Die installierte CLI ist die maßgebliche Quelle für ihre aktuellen Befehlsflags und Ausgabestrukturen. Verwenden Sie lvl skill describe wenn Sie eine maschinenlesbare Befehlsreferenz benötigen.