Level CLI, oder lvlermöglicht es Ihnen, über ein Terminal mit Ihrem Level-Konto zu arbeiten. Sie können Geräte, Aktualisierungen, Dateien, Monitore, Warnmeldungen, Skripte, Automatisierungen und den Ausführungsverlauf einsehen, ohne zur Level-Webanwendung wechseln zu müssen.

Sie können auch die Level-Erweiterung für einen Programmieragenten installieren. Die Erweiterung bringt unterstützten Agenten bei, wie sie die Befehle und die JSON-Ausgabe Ihrer installierten Version von lvl. Sie stellen den Programmieragenten, das Modell und die Token bereit.

ℹ️ HINWEIS: Die lvl CLI verwaltet Ihr Level-Konto. Sie ist vom Level-Agenten getrennt, der auf verwalteten Geräten installiert ist.

Bevor Sie beginnen

Sie benötigen:

Ein Level-Konto mit Zugriff auf die CLI.
Einen unterstützten Computer mit Windows, macOS oder Linux auf einem AMD64- oder ARM64-Prozessor.
Einen Browser, mit dem Sie die CLI-Anmeldung genehmigen können.

Wenn Sie lvl mit einem Programmieragenten verwenden möchten, installieren Sie diesen Agenten separat. Level hostet das Modell nicht und stellt keine Token bereit.

CLI installieren

Öffnen Sie die Seite „Level CLI-Versionen". (Demnächst verfügbar)
Laden Sie das Archiv herunter, das zu Ihrem Betriebssystem und Prozessor passt:
- windows-amd64 oder windows-arm64
- darwin-amd64 oder darwin-arm64 für macOS
- linux-amd64 oder linux-arm64
Vergleichen Sie das heruntergeladene Archiv mit dem SHA-256-Wert in checksums.txt für das Release.
Entpacken Sie das Archiv.
Benennen Sie die ausführbare Datei um in lvl (lvl.exe unter Windows), und verschieben Sie es dann in ein Verzeichnis auf Ihrem PATH.
Bestätigen Sie, dass die CLI verfügbar ist:

lvl --help

Anmelden

Ausführen:

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 üblichen 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 angezeigte URL in einen Browser auf einem beliebigen Computer.

Aktive Sitzung prüfen:

lvl auth status

Abmelden und die lokale Sitzung entfernen:

lvl auth logout

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 anhand des Hostnamens, Namens, Spitznamens oder eines gruppenqualifizierten Hostnamens wie Servers/web-01. Wenn ein Name mit mehr als einem Datensatz übereinstimmt, lvl hält an und fordert stattdessen eine genauere Referenz an, anstatt eine auszuwählen.

Ausgabeformat auswählen

Die meisten Befehle zeigen standardmäßig eine Tabelle an. Verwenden Sie JSON, wenn ein anderes Programm das Ergebnis lesen soll:

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'

Listenbefehlsergebnisse sind standardmäßig auf 100 Einträge begrenzt. 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üssel-Befehlen kann das vollständige Token enthalten. Schützen Sie exportierte Daten und CI-Protokolle, und übertragen Sie keine Anmeldedaten in 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 richten Sie sich mit --group.

Ohne --wait, gibt der Befehl die neuen Ausführungs-IDs zurück, nachdem Level die Anfrage akzeptiert hat. Verwenden Sie die Ausführungsbefehle, um Fortschritt und Ergebnisse zu prüfen:

lvl run list
lvl run get  --wait

Weitere Informationen zu gespeicherten Skripten, Shells, Zeitüberschreitungen, Variablen, Ausgabe und Exit-Codes finden Sie unter Skripterstellung – Übersicht.

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 vorab 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 Namen der Automatisierung, 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 nacheinander angewendet, nicht als eine Transaktion, sodass ein Fehler frühere Änderungen bestehen lassen kann. Führen Sie immer --dry-run, den Plan prüfen und vor dem Anwenden von Änderungen einen aktuellen Export aufbewahren.

Automatisierungsspezifikationen verweisen auf Kontoressourcen wie Skripte, Gruppen, Tags, Dateien und benutzerdefinierte Felder per ID. Behandeln Sie eine exportierte Spezifikation als Momentaufnahme für dasselbe Level-Konto.

Informationen zu Automatisierungskonzepten und zum Web-Editor finden Sie unter Automatisierungen – Übersicht und Automatisierungen erstellen.

lvl mit einem Programmieragenten verwenden

Die durch Ihre aktuelle lvl Version:

lvl skill install

Der Befehl installiert eine SKILL.md Datei, in der unterstützte Programmieragenten sie finden können. Beispiele sind Cursor, Claude Code, Codex, Gemini, Hermes und OpenClaw.

Nach der Installation können Sie Ihren Programmieragenten bitten, Ihre Geräteflotte über lvl, ein Skript entwerfen oder eine Automatisierungsspezifikation entwerfen. Überprüfen Sie jeden vorgeschlagenen Befehl und jede Datei, bevor Sie diese ausführen oder anwenden.

Erweiterung nach dem Upgrade von lvl damit sein Befehlsindex und seine Ausgabedefinitionen mit der installierten Version übereinstimmen:

lvl skill install

Die generierte Erweiterung anzeigen, ohne sie zu installieren:

lvl skill show

Die aktuellen Flags und die JSON-Ausgabestruktur für einen Befehl anzeigen:

lvl skill describe device list
lvl skill describe automation action add

ℹ️ HINWEIS: Durch die Installation der Erweiterung wird weder ein Programmieragent installiert noch Level mit einem LLM-Anbieter verbunden. Sie wählen und konfigurieren den Programmieragenten, 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, wie z. B. CI, schlagen Befehle, die eine Bestätigung erfordern, fehl, sofern Sie nicht --yes.

Manche 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-Webanwendung, um das endgültige Ergebnis zu bestätigen.

⚠️ WARNUNG: Behandeln Sie Installationsschlüssel, API-Token, exportierte Inventare, Skriptausgaben und Automatisierungsdateien als vertraulich. Vermeiden Sie deren Ausgabe in gemeinsam genutzten Terminals oder CI-Protokollen.

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.

Verwandte Artikel

Level CLI (lvl): Erste Schritte