Coding Agents

Coding-Agents

Claude Code, Codex, Cursor und andere KI-Coding-Agents deployen und verwalten Apps 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, … } zurück — content ist die vollständige Anleitung (Build-Pipeline, env-Priorität, Add-ons, Discovery, Exit-Codes). Zugehörige Unterbefehle:

lizard skills list        # available embedded skills
lizard skills get core    # the core guide
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.
  2. Authentifizierung optimistisch prüfen: Führe die Aufgabe des Nutzers aus; bei Exit-Code 2 führe lizard login aus, gib die ausgegebene URL an den Nutzer weiter und versuche es dann erneut.
  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). 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).
  5. Handeln mithilfe der Anleitung — 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. 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:

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: Services und Add-ons erstellen, neu deployen, Logs und Metriken lesen, Secrets setzen, Replicas skalieren und Domains anhängen. Es ist ein gehosteter Server, der Streamable HTTP spricht unter:

https://employ-woman-g1q2.us-east-1.onlizard.com/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://employ-woman-g1q2.us-east-1.onlizard.com/mcp

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

{
  "mcpServers": {
    "lizard": {
      "url": "https://employ-woman-g1q2.us-east-1.onlizard.com/mcp",
      "headers": { "Authorization": "Bearer liz_your_key" }
    }
  }
}

Das Starten der Testphase, das Bezahlen und das Kündigen von Pro 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