Studio CLI

Dieser Text wurde mithilfe von KI übersetzt. Wenn du den Originaltext auf Englisch lesen möchtest, klicke hier.

Studio CLI ist ein global verfügbares Befehlszeilentool, mit dem du über dein Terminal mit den Funktionen von WordPress Studio interagieren kannst – unabhängig davon, ob Studio geöffnet ist oder nicht.

Es ist besonders nützlich für:

• Verwaltung lokaler Studio-Websites.
• Erstellen und Aktualisieren von Vorschau-Websites auf WordPress.com.
• Ausführen von WP-CLI-Befehlen.
• Integration mit KI-Coding-Agenten. Jede Website enthält eine AGENTS.md-Datei.
• Integration von Studio in Skripte und Build-Schritte.

Installation

1. Öffne die Anwendung „WordPress Studio“.
2. Öffne über das Hauptmenü das Einstellungen-Fenster. Du kannst auch auf das Zahnradsymbol in der oberen rechten Ecke der App klicken.
3. Aktiviere die Option „Studio CLI“ und klicke auf Speichern.
4. Unter macOS wirst du aufgefordert, dein Kontopasswort einzugeben, um die Installation zu erlauben.

Verwendung

Die Studio CLI wird mit dem Befehl studio aufgerufen. Alle Befehle folgen dem Muster:

studio <area> <command> [options]

Du kannst jederzeit eine allgemeine Übersicht aufrufen mit:

studio --help

Die meisten Befehle sind dafür vorgesehen, im Stammverzeichnis einer von Studio verwalteten Website ausgeführt zu werden. Um ein anderes Website-Verzeichnis als dein aktuelles Arbeitsverzeichnis anzugeben, verwende die Option --path:

studio <area> <command> --path /path/to/site

Authentifizierungsbefehle

Verwende die auth-Befehle, um deine WordPress.com-Authentifizierung für Studio-Funktionen zu verwalten, die einen angemeldeten Benutzer erfordern (z. B. Vorschau-Websites).

studio auth login      # Log in to WordPress.com
studio auth logout     # Log out and clear WordPress.com authentication
studio auth status     # Check authentication status

• studio auth login öffnet einen browserbasierten Ablauf, um die CLI mit deinem WordPress.com-Konto zu verbinden. Du erhältst ein Authentifizierungstoken, das du in das Terminal einfügst, um den Anmeldevorgang abzuschließen.
• studio auth status zeigt an, ob du derzeit authentifiziert bist und welches Konto verwendet wird.
• studio auth logout trennt die CLI von deinem WordPress.com-Konto und löscht gespeicherte Anmeldedaten.

Wenn du einen Befehl ausführst, der eine Authentifizierung erfordert (z. B. studio preview create), während du abgemeldet bist, gibt die CLI einen Fehler zurück und leitet dich zum Anmelden an.

Verwende das Flag --help für detaillierte Optionen zu jedem Authentifizierungsbefehl:

studio auth --help
studio auth login --help

Befehle für Vorschau-Websites

Vorschau-Websites sind temporäre, teilbare Umgebungen, die auf WordPress.com gehostet werden und deine lokale Studio-Website spiegeln. Nutze sie, um deine Arbeit mit Teammitgliedern oder Stakeholdern zu teilen, ohne dass eine lokale Umgebung erforderlich ist.

studio preview create          # Create a preview site
studio preview list            # List preview sites
studio preview update <host>   # Update an existing preview site
studio preview delete <host>   # Delete a preview site

Eine Vorschau-Website erstellen

Führe im Stammverzeichnis deiner lokalen Studio-Website folgenden Befehl aus:

cd /path/to/your/studio-site
studio preview create

Dieser Befehl wird:

• Deine lokale Website erstellen und in eine Vorschau-Umgebung hochladen.
• Eine Vorschau-URL zurückgeben, die du mit anderen teilen kannst.
• Erfordern, dass du mit studio auth login angemeldet bist.

Du kannst auch ein Website-Verzeichnis explizit angeben:

studio preview create --path /path/to/your/studio-site

Vorschau-Websites auflisten

So zeigst du alle mit deinem Konto verknüpften Vorschau-Websites an:

studio preview list

Dies zeigt den Host jeder Vorschau an (zum Beispiel example-preview.wpcomstaging.com), den du mit den Befehlen update und delete verwendest.

Vorschau-Websites aktualisieren und löschen

Jede Vorschau-Website wird durch ihren Hostnamen identifiziert:

# Rebuild and redeploy changes from your local site to the preview site:
studio preview update <host>

# Permanently remove a preview site:
studio preview delete <host>

Verwende studio preview list, um den passenden <host>-Wert zu ermitteln, falls du ihn nicht zur Hand hast.

Für die vollständige Liste der Optionen:

studio preview --help
studio preview create --help
studio preview update --help
studio preview delete --help

Befehle zur Verwaltung lokaler Websites

Verwende die site-Befehle, um lokale Studio-Websites auf deinem Rechner zu verwalten: erstellen, starten, stoppen, auflisten und konfigurieren.

studio site status    # Get status of local site
studio site create    # Create a new local site
studio site list      # List local sites
studio site start     # Start local site
studio site stop      # Stop local site(s)
studio site delete    # Delete local site
studio site set       # Configure site settings

Eine lokale Website erstellen

Du kannst den create-Befehl aus einem leeren Verzeichnis heraus ausführen oder aus einem Verzeichnis, das bereits die Dateien einer WordPress-Website enthält, aber noch nicht in Studio aufgeführt ist.

So erstellst du eine neue lokale Website, die von Studio verwaltet wird:

# Create a new site in the current working directory, using all the default options
studio site create

# Create a new site with a custom domain and HTTPS
studio site create --https --domain hello.wp.local

# Create a new site in a different directory
studio site create --path /path/to/site

Dadurch wird eine neue Website in deinem aktuellen Arbeitsverzeichnis erstellt, der WordPress-Server gestartet und nach Abschluss automatisch wp-admin in deinem Browser geöffnet.

Es gibt mehrere unterstützte Flags, die du beim Erstellen einer neuen Website verwenden kannst. Für die vollständige Liste der Optionen:

studio site create --help

Eine lokale Website mithilfe der Blueprints-Galerie erstellen

Studio bietet Zugriff auf die Blueprints-Galerie, in der du Blueprints auswählen und aktivieren kannst, um eine Website zu erstellen. Die Blueprints-Galerie ist auch über die CLI verfügbar. Die Befehle für die Arbeit mit Blueprints sind:

# Show all available blueprints for creating a local Studio site
studio blueprint list

# Create a local site with selected blueprint
studio blueprint use <blueprint-slug> --name "<site-name>"

Websites auflisten und inspizieren

# Show all local sites known to Studio:
studio site list

# Show details and current status for the site in the current directory:
studio site status

# Or explicitly for a given path:
studio site status --path /path/to/site

Die Statusausgabe enthält Informationen wie:

• Ob die Website läuft.
• Lokale URL (zum Beispiel http://localhost:PORT).
• Wichtige Konfigurationsdetails (PHP-Version, Datenbankstatus usw.).

Websites starten und stoppen

# From inside a site directory:
studio site start
studio site stop

# Or by path:
studio site start --path /path/to/site
studio site stop --path /path/to/site

Beim Starten einer Website werden die lokalen Dienste gestartet, die für den Zugriff im Browser erforderlich sind. Beim Stoppen werden diese Dienste heruntergefahren.

Eine lokale Website löschen

# Delete a site from Studio
studio site delete

# Delete the site and move the site directory to the system trash
studio site delete --files

Dieser Befehl entfernt die Website aus Studio und optional auch die Website-Dateien von der Festplatte.

Website-Einstellungen konfigurieren

Verwende studio site set, um die Einstellungen für eine bestimmte lokale Website anzupassen.

studio site set [options]

Beispiele für die Verwendung dieses Befehls:

• Ändern der PHP-Version oder WordPress-Version.
• Anpassen der lokalen Domain oder des Ports.
• Umschalten von Funktionen, die das Verhalten der lokalen Umgebung beeinflussen.

Um die vollständige Liste der konfigurierbaren Optionen anzuzeigen, führe folgenden Befehl aus:

studio site set --help

WP-CLI über Studio verwenden

Der Befehl studio wp gibt dir Zugriff auf WP-CLI im Kontext einer von Studio verwalteten Website, ohne dass du WP-CLI separat installieren oder konfigurieren musst.

studio wp [<wp-cli-command>] [<wp-cli-arguments>...]

Beispiele (ausgeführt im Stammverzeichnis deiner Website):

# Check WordPress version:
studio wp core version

# List installed plugins:
studio wp plugin list

# Run database upgrades:
studio wp core update-db

Wichtige Hinweise:

• Du benötigst keine separate WP-CLI-Installation; Studio stellt WP-CLI bereit und konfiguriert es für dich.
• Umgebungsvariablen, Pfade und Anmeldedaten werden automatisch basierend auf der ausgewählten Website gesetzt, sodass Befehle auf die richtige Datenbank und die richtigen Dateien zugreifen.
• Du kannst --path verwenden, wenn du dich nicht im Verzeichnis der Website befindest:

  studio wp plugin list --path /path/to/site

Eine vollständige Liste der unterstützten WP-CLI-Unterbefehle und -Argumente findest du in der WP-CLI-Dokumentation oder führe folgenden Befehl aus:

studio wp help
studio wp help <command>

Studio CLI mit KI-Coding-Agenten verwenden

Die Studio CLI funktioniert gut mit KI-gestützten Entwicklungstools und -Agenten wie Claude Code, Cursor und anderen IDE-Erweiterungen, die Shell-Befehle in deinem Namen ausführen können.

Da diese Tools deine Projektdateien einsehen und Terminalbefehle ausführen können, sind sie in der Lage:

• Zu erkennen, dass du in einem von Studio verwalteten WordPress-Projekt arbeitest.
• studio-Befehle automatisch aufzurufen, um lokale Websites, Vorschauen und WP-CLI-Aufgaben zu verwalten.
• Befehlsausgaben zu nutzen, um weitere Codeänderungen oder Debugging-Schritte einzuleiten.

Typische Workflows mit KI-Agenten

Im Folgenden findest du einige konkrete Möglichkeiten, die Studio CLI mit einem KI-Coding-Agenten zu kombinieren.

1. Eine lokale Website erstellen und verwalten

Du kannst deinen KI-Agenten anweisen, über Studio eine lokale WordPress-Website zu erstellen und auszuführen. Zum Beispiel in deinem Editor:

„Richte mit Studio in diesem Ordner eine neue lokale WordPress-Website mit PHP-Version 8.2 ein, starte sie und nenne mir die lokale URL.“

Im Hintergrund führt der Agent möglicherweise Folgendes aus:

studio site create --php 8.2
studio site start
studio site status

Das ist nützlich, wenn:

• Schnell einen Prototyp für ein neues Plugin oder Theme erstellt werden soll.
• Du in ein bestehendes Projekt einsteigst und der Agent die Umgebung für dich einrichten soll.

2. Automatisiertes Debugging und WP-CLI-Operationen

Wenn der Agent eine Korrektur oder Änderung vorschlägt, kann er auch Prüfungen mit studio wp ausführen:

# Run database upgrades:
studio wp core update-db

# Check for current plugins:
studio wp plugin list

Du könntest zum Beispiel fragen:

„Führe über Studio alle nötigen WP-CLI-Prüfungen durch, um herauszufinden, warum die Website einen 500-Fehler auslöst, und schlage dann Lösungen vor.“

Der Agent kann iterativ:

1. studio wp-Befehle ausführen, um Diagnosedaten zu sammeln.
2. Code oder Konfiguration aktualisieren.
3. Befehle erneut ausführen, um die Lösung zu überprüfen.

3. Vorschau-Websites zur Überprüfung erstellen und aktualisieren

Agenten können dir helfen, Vorschau-Umgebungen einzurichten und zu pflegen, die an deinen Branch oder dein Feature gebunden sind:

„Erstelle eine Vorschau-Website für dieses Projekt und gib mir die teilbare URL. Aktualisiere nach jeder Codeänderung dieselbe Vorschau.“

Das entspricht folgenden Befehlen:

studio auth login              # if needed
studio preview create          # initial deployment
studio preview update <host>   # after subsequent changes

Dies ist besonders nützlich, wenn:

• Fortschritte mit nicht-technischen Stakeholdern teilen.
• Zusammenarbeit mit Teammitgliedern, die das Live-Verhalten sehen müssen, ohne eine lokale Umgebung einzurichten.

Best Practices bei der Verwendung von KI-Agenten mit Studio CLI

• Im Stammverzeichnis einer Studio-Website bleiben: Viele Befehle setzen voraus, dass das aktuelle Verzeichnis eine von Studio verwaltete Website ist. Weise deinen Agenten an, mit cd in den richtigen Ordner zu wechseln oder --path zu verwenden.
• Anweisungen explizit formulieren: Erwähne beim Prompten eines Agenten „verwende die studio CLI“ und etwaige Einschränkungen, zum Beispiel:
  • „Lösche keine bestehenden Websites.“
  • „Frage vor der Ausführung von Datenbankmigrationen um Bestätigung.“
  • „Führe nur schreibgeschützte studio wp-Befehle aus.“
• Destruktive Operationen überprüfen: Befehle wie studio site delete und studio preview delete können Umgebungen entfernen. Bitte den Agenten, die geplanten Befehle vor der Ausführung anzuzeigen.
• Authentifizierung bewusst einsetzen: Stelle bei Befehlen, die WordPress.com-Zugriff erfordern (studio auth login, studio preview ...), sicher, dass du damit einverstanden bist, dass der Agent Anmeldevorgänge initiiert, und bestätige, welches Konto verwendet wird.

Durch die Kombination von Studio CLI mit KI-Coding-Agenten kannst du einen Großteil der repetitiven Umgebungseinrichtung, Tests und Deployment-Orchestrierung auslagern und dich stärker auf das Schreiben und Überprüfen deines WordPress-Codes konzentrieren.

Hilfe erhalten

Jeder Befehl und Unterbefehl unterstützt --help für Inline-Dokumentation, Verwendung und verfügbare Optionen. Zum Beispiel:

studio --help
studio auth --help
studio preview create --help
studio site start --help
studio site set --help
studio wp help

Dies ist der beste Weg, die Funktionen der spezifischen Version von Studio CLI zu erkunden, die du installiert hast.