Studio CLI

Deze tekst is vertaald met AI. Als je de oorspronkelijke tekst in het Engels wilt bekijken, klik hier.

Studio CLI is een wereldwijd beschikbare command-line utility waarmee je vanuit je terminal met WordPress Studio-functies kunt werken, ongeacht of Studio geopend is of niet.

Dit is vooral handig voor:

• Lokale Studio-sites beheren.
• Voorbeeldsites op WordPress.com maken en bijwerken.
• WP-CLI-opdrachten uitvoeren.
• Integreren met AI-codeeragents. Elke site bevat een AGENTS.md-bestand.
• Studio integreren in scripts en buildstappen.

Installatie

1. Open de applicatie “WordPress Studio“.
2. Open vanuit het hoofdmenu het venster Instellingen. Je kunt ook op het tandwielpictogram rechtsboven in de app klikken.
3. Schakel de optie “Studio CLI” in en klik op Opslaan.
4. Op macOS wordt je gevraagd om het wachtwoord van je account om de installatie toe te staan.

Gebruik

De Studio CLI wordt aangeroepen met de opdracht studio. Alle opdrachten volgen het patroon:

studio <area> <command> [options]

Je kunt op elk moment een algemeen overzicht bekijken met:

studio --help

De meeste opdrachten zijn bedoeld om uit te voeren vanuit de hoofdmap van een door Studio beheerde site. Als je een andere sitemap dan je huidige werkmap wilt gebruiken, gebruik je de optie --path:

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

Authenticatieopdrachten

Gebruik de auth-opdrachten om je WordPress.com-authenticatie te beheren voor Studio-functies waarvoor een ingelogde gebruiker nodig is (bijvoorbeeld voorbeeldsites).

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 opent een browsergebaseerd proces om de CLI te koppelen aan je WordPress.com-account. Je ontvangt een authenticatietoken dat je in de terminal kunt plakken om het inlogproces te voltooien.
• studio auth status geeft aan of je momenteel geauthenticeerd bent en toont welk account in gebruik is.
• studio auth logout koppelt de CLI los van je WordPress.com-account en wist opgeslagen inloggegevens.

Als je een opdracht uitvoert waarvoor authenticatie vereist is (zoals studio preview create) terwijl je uitgelogd bent, geeft de CLI een foutmelding en word je gevraagd om in te loggen.

Gebruik de vlag --help voor gedetailleerde opties voor elke auth-opdracht:

studio auth --help
studio auth login --help

Opdrachten voor preview-sites

Preview-sites zijn tijdelijke, deelbare omgevingen die worden gehost op WordPress.com en je lokale Studio-site spiegelen. Gebruik ze om werk te delen met teamgenoten of belanghebbenden zonder dat er een lokale omgeving nodig is.

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

Een preview-site maken

Vanaf de root van je lokale Studio-site:

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

Dit doet het volgende:

• Je lokale site bouwen en uploaden naar een previewomgeving.
• Een preview-URL retourneren die je met anderen kunt delen.
• Vereisen dat je bent ingelogd met studio auth login.

Je kunt ook expliciet een sitedirectory opgeven:

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

Previewsites weergeven

Om alle previewsites te bekijken die aan je account zijn gekoppeld:

studio preview list

Dit toont de host van elke preview (bijvoorbeeld example-preview.wpcomstaging.com), die je gebruikt met de opdrachten update en delete.

Previewsites bijwerken en verwijderen

Elke previewsite wordt geïdentificeerd aan de hand van de hostnaam:

# 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>

Gebruik studio preview list om de juiste waarde voor <host> te vinden als je die niet bij de hand hebt.

Voor de volledige set opties:

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

Opdrachten voor lokaal sitebeheer

Gebruik de site-opdrachten om lokale Studio-sites op je computer te beheren: ze maken, starten, stoppen, weergeven en configureren.

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

Een lokale site maken

Je kunt de opdracht create uitvoeren vanuit een lege map, of vanuit een map die al de bestanden van een WordPress-site bevat, maar die nog niet in Studio wordt vermeld.

Een nieuwe lokale site maken die door Studio wordt beheerd:

# 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

Hiermee maak je een nieuwe site aan in je huidige werkmap, start je de WordPress-server en wordt wp-admin automatisch in je browser geopend wanneer dit klaar is.

Er zijn verschillende ondersteunde vlaggen die je kunt gebruiken bij het maken van een nieuwe site. Voor de volledige set opties:

studio site create --help

Een lokale site maken met de Blueprints-galerij

Studio biedt toegang tot de Blueprints-galerij, waar je blueprints kunt kiezen en activeren om een site te maken. De Blueprints-galerij is ook beschikbaar via CLI. De opdrachten voor het werken met blueprints zijn:

# 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>"

Sites weergeven en inspecteren

# 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

De statusuitvoer bevat informatie zoals:

• Of de site actief is.
• Lokale URL (bijvoorbeeld http://localhost:PORT).
• Belangrijke configuratiedetails (PHP-versie, databasestatus, enz.).

Sites starten en 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

Als je een site start, worden de lokale services gestart die nodig zijn om de site in een browser te openen. Als je de site stopt, worden die services afgesloten.

Een lokale site verwijderen

# Delete a site from Studio
studio site delete

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

Hiermee verwijder je de site uit Studio en, optioneel, de sitebestanden van de schijf.

Site-instellingen configureren

Gebruik studio site set om instellingen voor een specifieke lokale site aan te passen.

studio site set [options]

Voorbeelden waarvoor je deze opdracht kunt gebruiken zijn:

• De PHP-versie of WordPress-versie wijzigen.
• Het lokale domein of de poort aanpassen.
• Functies in- of uitschakelen die invloed hebben op hoe de lokale omgeving draait.

Voer het volgende uit om de volledige lijst met configureerbare opties te bekijken:

studio site set --help

WP-CLI gebruiken via Studio

Met de opdracht studio wp krijg je toegang tot WP-CLI binnen de context van een site die door Studio wordt beheerd, zonder dat je WP-CLI apart hoeft te installeren of configureren.

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

Voorbeelden (uitvoeren vanuit de hoofdmap van je site):

# Check WordPress version:
studio wp core version

# List installed plugins:
studio wp plugin list

# Run database upgrades:
studio wp core update-db

Belangrijkste punten:

• Je hebt geen aparte WP-CLI-installatie nodig; Studio levert en configureert die voor je.
• Omgevingsvariabelen, paden en inloggegevens worden automatisch ingesteld op basis van de geselecteerde site, zodat opdrachten op de juiste database en bestanden worden uitgevoerd.
• Je kunt --path gebruiken als je je niet in de sitedirectory bevindt:

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

Raadpleeg de WP-CLI-documentatie of voer het volgende uit voor een volledige lijst met ondersteunde WP-CLI-subopdrachten en argumenten:

studio wp help
studio wp help <command>

Studio CLI gebruiken met AI-codeeragents

De Studio CLI werkt goed met AI-ondersteunde ontwikkeltools en agents zoals Claude Code, Cursor en andere IDE-extensies die namens jou shell-opdrachten kunnen uitvoeren.

Omdat deze tools je projectbestanden kunnen zien en terminalopdrachten kunnen uitvoeren, kunnen ze:

• Detecteren dat je in een door Studio beheerd WordPress-project werkt.
• Automatisch studio-opdrachten aanroepen om lokale sites, previews en WP-CLI-taken te beheren.
• Opdrachtuitvoer gebruiken om verdere codewijzigingen of foutopsporingsstappen te begeleiden.

Typische workflows met AI-agents

Hieronder vind je een aantal concrete manieren om Studio CLI te combineren met een AI-codeeragent.

1. Een lokale site opzetten en beheren

Je kunt je AI-agent opdracht geven om via Studio een lokale WordPress-site te maken en uit te voeren. Bijvoorbeeld in je editor:

“Stel een nieuwe lokale WordPress-site in met PHP-versie 8.2 via Studio in deze map, start deze en vertel me de lokale URL.”

Achter de schermen voert de agent mogelijk het volgende uit:

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

Dit is handig wanneer:

• Je snel een nieuwe plugin of nieuw thema wilt prototypen.
• Je aan de slag gaat met een bestaand project en wilt dat de agent de omgeving voor je instelt.

2. Geautomatiseerde debugging en WP-CLI-bewerkingen

Wanneer de agent een oplossing of wijziging voorstelt, kan deze ook controles uitvoeren met studio wp:

# Run database upgrades:
studio wp core update-db

# Check for current plugins:
studio wp plugin list

Je kunt vragen:

“Voer via Studio alle WP-CLI-controles uit die je nodig hebt om vast te stellen waarom de site een 500-fout geeft, en stel vervolgens oplossingen voor.”

De agent kan iteratief:

1. studio wp-opdrachten uitvoeren om diagnostische gegevens te verzamelen.
2. Code of configuratie bijwerken.
3. Opdrachten opnieuw uitvoeren om de oplossing te verifiëren.

3. Preview-sites maken en bijwerken voor beoordeling

Agents kunnen je helpen preview-omgevingen in te stellen en te onderhouden die aan je branch of functie zijn gekoppeld:

“Maak een preview-site voor dit project en geef me de deelbare URL. Werk daarna na elke codewijziging dezelfde preview bij.”

Dat vertaalt zich naar:

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

Dit is vooral handig wanneer:

• Voortgang delen met niet-technische belanghebbenden.
• Samenwerken met teamgenoten die live gedrag moeten zien zonder een lokale omgeving in te stellen.

Best practices bij het gebruik van AI-agents met Studio CLI

• Blijf in de root van een Studio-site: Veel opdrachten gaan ervan uit dat de huidige map een door Studio beheerde site is. Herinner je agent eraan om met cd naar de juiste map te gaan of om --path te gebruiken.
• Wees expliciet in instructies: Wanneer je een agent aanstuurt, vermeld dan “gebruik de studio CLI” en eventuele beperkingen, bijvoorbeeld:
  • “Verwijder geen bestaande sites.”
  • “Vraag om bevestiging voordat je databasemigraties uitvoert.”
  • “Voer alleen alleen-lezen-studio wp-opdrachten uit.”
• Controleer destructieve bewerkingen: Opdrachten zoals studio site delete en studio preview delete kunnen omgevingen verwijderen. Vraag de agent om de opdrachten te tonen die hij wil uitvoeren voordat hij ze uitvoert.
• Gebruik authenticatie bewust: Voor opdrachten waarvoor toegang tot WordPress.com vereist is (studio auth login, studio preview ...), moet je ervoor zorgen dat je het goed vindt dat de agent inlogflows start, en bevestigen welk account wordt gebruikt.

Door Studio CLI te combineren met AI-codingagents kun je een groot deel van de repetitieve omgevingsconfiguratie, het testen en de implementatieorkestratie uitbesteden, zodat je je meer kunt richten op het schrijven en beoordelen van je WordPress-code.

Hulp krijgen

Elke opdracht en subopdracht ondersteunt --help voor inline documentatie, gebruik en beschikbare opties. Bijvoorbeeld:

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

Dit is de beste manier om de mogelijkheden te verkennen van de specifieke versie van Studio CLI die je hebt geïnstalleerd.