Coding Agents

Coding-Agents

Claude Code, Codex, Cursor und andere KI-Coding-Agents erstellen Sandboxes, deployen Apps und verwalten sie auf Lizard (lizard.build) über Lizard CLI. Installiere Lizard Skill einmal mit npx skills add lizard-build/skill -g; der Agent lädt dann mit lizard skills get core --json die in die CLI eingebaute Anleitung und liest die Flags jedes Befehls mit --help --json und kennt so die verfügbaren Optionen. Clients mit MCP-Unterstützung, etwa ChatGPT und Claude, können stattdessen Lizard MCP verwenden. Einen vollständigen Deploy mit einem Agenten zeigt Deploy aus Claude Code, Codex oder Cursor.

Das eingebettete Skill

Die maßgebliche Nutzungsanleitung befindet sich in der CLI und ist mit ihr versioniert, sodass sie immer zur installierten Version passt. Ein Agent liest sie mit:

lizard skills get core --json

Dies gibt { name, frontmatter, content, references, … } zurück — content ist die Kernanleitung (Sandboxes, Deploys, Datenbanken, Secrets, Discovery, Exit-Codes), und references listet die ausführlichen Anleitungen zu Deploys, Sandboxes und Lizard SDK. Zugehörige Unterbefehle:

lizard skills list                     # available embedded skills
lizard skills get core                 # the core guide
lizard skills get core --ref deploys   # one reference: deploys, sandboxes or sdk
lizard skills get core --full          # the guide plus every reference
lizard skills path                     # where skills are stored

Da die Anleitung mit dem Binary gebündelt ist, aktualisiert lizard upgrade auch die Anweisungen des Agenten.

Selbstbeschreibende Befehle

Agents ermitteln die exakten Flag-Formen zur Laufzeit, statt sich auf auswendig gelernte Syntax zu verlassen:

lizard --help --json                # full command tree + exit codes
lizard <cmd> --help --json          # a specific command's schema

Siehe JSON & Automatisierung.

Bootstrapping in einem Agenten

Ein typischer Agent-Ablauf:

  1. Anleitung laden: lizard skills get core --json → content lesen, dann die Referenz, die die Aufgabe braucht (--ref sandboxes, deploys oder sdk).
  2. Authentifizierung optimistisch prüfen: Führe die Aufgabe des Nutzers aus. Bei Exit-Code 2 (NOT_AUTHENTICATED) enthält body.login im Fehler die Anmeldelinks: Frag den Nutzer, ob er sich mit GitHub oder Google anmeldet, gib ihm diesen Link aus authUrls und versuche es erneut, sobald der Browser „CLI authorized“ anzeigt. lizard login --json gibt dieselben Links aus und meldet nach der Anmeldung den Plan in account.state.
  3. Testphase starten, wenn gewünscht: Ein neues Konto hat keinen Plan, daher schlägt das erste Erstellen mit HTTP 402 fehl (code: "PAYMENT_REQUIRED", Exit-Code 1). Frag zuerst den Nutzer. Wenn er zustimmt, führe lizard billing start --json aus, gib die Checkout-url an den Nutzer weiter und versuche es erneut, sobald eine Karte hinzugefügt wurde.
  4. Kontext vor Änderungen auflösen: lizard status (cwd-Link) und lizard ps --json (Services). In einem nicht verknüpften Ordner verwenden up, add, sandbox create und andere Projektbefehle das Standardprojekt des Kontos.
  5. Handeln mithilfe der Anleitung — sandbox create, add, up, secrets, domain usw., immer mit --json.

Wenn das Binary lizard nicht vorhanden ist, installiere es zuerst. Verwende unter macOS oder Linux das Installationsskript:

curl -fsSL https://lizard.build/install.sh | bash

Es braucht weder Node.js noch sudo und verlinkt lizard in einen Ordner, der bereits im PATH liegt. So kann der Agent es in derselben Sitzung aufrufen. Meldet das Skript, dass lizard eventuell nicht gefunden wird, rufe stattdessen ~/.lizard/bin/lizard auf. Ohne Terminal endet das Skript mit der Ausgabe von lizard login --json: den Anmeldelinks und einer instruction. Gib den Link an den Nutzer weiter. Führe unter Windows Folgendes in PowerShell aus:

irm https://lizard.build/api/cli/install.ps1 | iex

Oder installiere es auf jedem System über npm (benötigt Node.js 20 oder neuer):

npm install -g @lizard-build/cli

Konventionen, denen Agents folgen sollten

  • Übergib bei nicht interaktiven Aufrufen immer --json.
  • Bestätige destruktive Aktionen (Service löschen, Add-on entfernen, ein projektweites Secret überschreiben, Prod-Neustart) mit dem Nutzer — die eigenen Prompts der CLI werden nur in einer TTY ausgelöst.
  • Beschränke Secrets standardmäßig auf den Service, der sie verwendet; reserviere --global für nachweislich öffentliche Werte. Siehe Variablen & Secrets.
  • Schreibe Dockerfiles nicht ungefragt — lizardpack erkennt die meisten Stacks automatisch. Versuche zuerst ein Deployment. Siehe Build-Pipeline.
  • Verwende lizard up nicht, um einen git-basierten Service auf Upload umzustellen — verwende service set + redeploy.

Editor-Integrationen

Lizard Skill wird als öffentliches Bootstrap verteilt, damit Agents in Editoren und Assistenten es bei Bedarf installieren und laden und dann dieselbe CLI steuern können, die in dieser Dokumentation beschrieben wird. Installiere es einmal für alle deine Agents:

npx skills add lizard-build/skill -g

Es funktioniert mit Claude Code, Cursor, Codex, Copilot, Gemini CLI und anderen Agents, die das Agent-Skills-Format lesen. Für Clients, die MCP statt Shell-Befehlen verwenden, nutze Lizard MCP.

Das gilt auch für KI-IDEs: Sie schreiben und testen eine App, hosten sie aber nicht. Siehe Deployment einer in Google Antigravity gebauten App, wo ein einziger Prompt das gesamte Deployment steuert.

Damit Claude Code oder ChatGPT die Seite bearbeiten kann, die du in Chrome geöffnet hast, verwende Lizard Studio.

Lizard MCP

Mit Lizard MCP können ChatGPT, Claude und andere MCP-Clients deine Lizard-Projekte verwalten: Sandboxes erstellen, darin Befehle ausführen und Dateien lesen oder schreiben; Services und Add-ons erstellen, neu deployen, einen Service, ein Projekt oder einen Workspace pausieren und fortsetzen, einen Service im Leerlauf schlafen lassen, Logs und Metriken lesen, Secrets setzen, Replicas skalieren und Domains anhängen. Es ist ein gehosteter Server, der Streamable HTTP spricht unter:

https://lizard.build/mcp

Ein Client, der OAuth unterstützt, meldet dich bei der ersten Nutzung an. Andere Clients senden einen liz_-API-Key im Header Authorization: Bearer; erstelle einen mit lizard keys create <name>.

Füge es zu Claude Code hinzu:

claude mcp add --transport http lizard https://lizard.build/mcp

Für Cursor und andere Clients, die per JSON konfiguriert werden:

{
  "mcpServers": {
    "lizard": {
      "url": "https://lizard.build/mcp",
      "headers": { "Authorization": "Bearer liz_your_key" }
    }
  }
}

Das Starten der Testphase, das Bezahlen, der Planwechsel und die Kündigung erfolgen auf der Billing-Seite. Muss das Konto zahlen, bevor etwas erstellt werden kann, enthält der Tool-Fehler PAYMENT_REQUIRED und den Link, der geöffnet werden muss.

Eigenen MCP-Server hosten

Ein Agent, der Lizard CLI verwendet, und eine Anwendung, die MCP bereitstellt, sind getrennte Workflows. Die oben genannten CLI-Befehle stellen keinen MCP-Transport bereit. Um deinen eigenen Server mit Streamable HTTP zu deployen, folge der Remote-MCP-Anleitung.

Siehe auch

App-Dashboard

Aktualisiert