CLI-Referenz

Die lizard CLI ist die primäre Schnittstelle zur Plattform. Diese Seite behandelt Installation, globale Flags, Exit-Codes und Laufzeit-Erkennung. Jeder Befehl hat seine eigene Referenzseite in der Seitenleiste — siehe lizard up, lizard service, lizard secrets und die übrigen.

Referenz generiert für CLI v0.3.62. Führe lizard <cmd> --help --json aus, um das exakte, versionspassende Schema eines beliebigen Befehls zu sehen.

Installation & Aktualisierung

npm install -g @lizard-build/cli
lizard --version
lizard upgrade            # update to the latest version
lizard upgrade --check    # check without installing

Verwende immer die global installierte lizard-Binärdatei — nicht npx. Hinweise zur Behebung von Berechtigungsfehlern findest du unter Quickstart.

Authentifizierung

lizard login                  # browser OAuth
lizard login --token lzd_xxx  # token auth
lizard logout
lizard whoami                 # current user, workspace, linked project

In CI solltest du LIZARD_TOKEN in der Umgebung setzen, statt login auszuführen.

Globale Flags

Flag	Beschreibung
`-V, --version`	CLI-Version ausgeben
`--json`	Maschinell lesbare Ausgabe. Mit `--help` kombinieren, um das Schema eines Befehls auszugeben

Die meisten Befehle akzeptieren außerdem -p, --project, -s, --service und -w, --workspace, um statt der verknüpften Ressource eine bestimmte Ressource anzusteuern.

Exit-Codes

Code	Bedeutung	Was zu tun ist
`0`	Erfolg	fortfahren
`1`	allgemeiner Fehler	Nachricht lesen
`2`	Authentifizierung (401/403)	`lizard login` ausführen
`3`	nicht gefunden (404)	Namen mit `lizard ps` / `lizard project list` prüfen
`4`	Zeitüberschreitung (408/504)	erneut versuchen
`5`	vom Benutzer abgebrochen	stoppen

Laufzeit-Erkennung

Die CLI dokumentiert sich selbst. Um den vollständigen Befehlsbaum, globale Flags und Exit-Codes anzuzeigen:

lizard --help --json

Für die exakten Argumente und Optionen eines beliebigen Befehls oder Unterbefehls:

lizard <cmd> --help --json
lizard <cmd> <sub> --help --json     # e.g. lizard service set --help --json

Das entspricht immer deiner installierten Version — ziehe es Vermutungen über Flag-Formen vor. So lernt auch ein Agent die CLI kennen, ohne darauf trainiert worden zu sein: siehe Deployment aus Claude Code.

Konfiguration & Status

Die CLI speichert Authentifizierung und die Projektverknüpfung des aktuellen Verzeichnisses in ~/.lizard/config.json.
lizard status zeigt die Workspace-/Projekt-/Service-Verknüpfung des cwd an (keine Authentifizierung erforderlich).
lizard config apply wendet eine lizard-config.json-Datei auf ein Projekt an (verwende --dry-run für eine Vorschau).

Sandbox-Volumes

Verwalte Persistent Volumes in einem Projekt über ihre Namen:

lizard volume create agent-workdir --size 10 --project proj_123
lizard volume list --project proj_123
lizard sandbox create --volume agent-workdir --project proj_123

Namen sind pro Projekt eindeutig: Kleinbuchstaben, Ziffern und Bindestriche, bis zu 64 Zeichen; Anfang und Ende müssen ein Buchstabe oder eine Ziffer sein. Neue Volumes akzeptieren ganze GB von 1 bis 50, standardmäßig 5. Die CLI liest vor dem Erstellen die aktuellen Servergrenzen und folgt Änderungen der Konfiguration. Bestehende größere Volumes behalten ihre Größe.

Nach dem Trennen löscht lizard volume rm agent-workdir --project proj_123 das Volume samt Daten. volume list zeigt Namen; --json enthält die erzeugten IDs.

Ereignisse & Verlauf JSON & Automatisierung