CLI-Referenz

Lizard CLI (lizard) deployt und verwaltet Apps, Datenbanken und Sandboxes auf Lizard (lizard.build) aus einem Terminal, einem CI-Job oder einem Coding-Agenten. 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, lizard pause und lizard resume, lizard sleep und die übrigen. Einen Überblick darüber, was die CLI kann, gibt die Seite zu Lizard CLI.

Referenz geschrieben für Lizard CLI v4.0.65. Führe lizard <cmd> --help --json aus, um das exakte, versionspassende Schema eines beliebigen Befehls zu sehen.

Installation & Aktualisierung

curl -fsSL https://lizard.build/install.sh | bash   # macOS and Linux
lizard --version
lizard upgrade            # update to the latest version
lizard upgrade --check    # check without installing

Die Flags findest du unter lizard upgrade.

Unter Windows führe irm https://lizard.build/api/cli/install.ps1 | iex in PowerShell aus. Mit Node.js kannst du stattdessen über npm installieren: npm install -g @lizard-build/cli.

Unter macOS und Linux aktualisiert sich die Binärdatei aus dem Installationsskript außerdem im Hintergrund selbst, höchstens einmal alle 6 Stunden und nur, wenn sie in einem interaktiven Terminal läuft. Die Prüfung wird übersprungen, wenn CI oder LIZARD_NO_UPDATE=1 gesetzt ist. Agenten, Skripte und CI-Jobs aktualisieren sich nie im Hintergrund; führe dort lizard upgrade selbst aus. Die Windows-Binärdatei aktualisiert sich nicht selbst: Führe den Installer erneut aus. Bei einer npm-Installation führt lizard upgrade npm für dich aus und gibt den npm-Befehl nur aus, wenn das fehlschlägt.

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

Authentifizierung

lizard login                  # GitHub or Google in the browser, then the Pro trial offer
lizard login --token liz_xxx  # API key auth
lizard logout
lizard whoami                 # current user, workspace, linked project

Referenzseiten: lizard login, lizard logout, lizard whoami und lizard workspace zum Auflisten und Erstellen von Workspaces.

API-Keys beginnen mit liz_. Erstelle einen mit lizard keys create <name>. In CI solltest du LIZARD_TOKEN (oder LIZARD_API_KEY) in der Umgebung setzen, statt login auszuführen.

Globale Flags

Die meisten Befehle akzeptieren außerdem -p, --project und -s, --service, um statt der verknüpften Ressource eine bestimmte Ressource anzusteuern. In einem nicht verknüpften Ordner verwenden sie Ihr Standardprojekt. init, link und project akzeptieren zusätzlich -w, --workspace. lizard add hat kein --project: Es verwendet das verknüpfte Projekt oder das Standardprojekt.

Exit-Codes

Ein Projekt- oder Service-Name, zu dem nichts passt, endet mit 1, nicht mit 3. lizard run, lizard sandbox exec und lizard sandbox ssh enden mit dem Exit-Code des Befehls selbst (127, wenn run den Befehl nicht findet). Eine 2 von ihnen kann also von deinem Befehl stammen statt von der Authentifizierung.

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 jedes Verzeichnisses in ~/.lizard/config.json. Eine Verknüpfung gilt genau für dieses Verzeichnis, nicht für seine Unterverzeichnisse. In einem Verzeichnis ohne Verknüpfung nutzen Projektbefehle das Standardprojekt deines Kontos: das älteste Projekt in deinem persönlichen Workspace.
• lizard status zeigt die Workspace-/Projekt-/Service-Verknüpfung des cwd an (keine Authentifizierung erforderlich). lizard link setzt diese Verknüpfung, lizard unlink entfernt sie, und lizard project listet, erstellt, pausiert, setzt fort und löscht Projekte.
• lizard config apply wendet eine lizard-config.json-Datei auf ein Projekt an (verwende --dry-run für eine Vorschau).
• lizard open öffnet das verknüpfte Projekt im Dashboard, und lizard docs öffnet diese Dokumentation.

Umgebungsvariablen

Sandbox-Volumes

Verwalte Persistent Volumes in einem Projekt über ihre Namen. Vollständige Referenz: lizard volume und lizard sandbox.

lizard volume create agent-workdir --size 10 --project proj_123
lizard volume list --project proj_123
lizard volume resize agent-workdir --size 20 --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.

Aktualisiert 21. Oktober 2026