Studio CLI

Questo testo è stato tradotto utilizzando l’IA. Se desideri visualizzare il testo originale in inglese, fai clic qui.

Studio CLI è un’utilità da riga di comando disponibile globalmente che ti consente di interagire con le funzionalità di WordPress Studio dal tuo terminale, indipendentemente dal fatto che Studio sia aperto o meno.

È particolarmente utile per:

• Gestire i siti Studio locali.
• Creare e aggiornare siti di anteprima su WordPress.com.
• Eseguire comandi WP-CLI.
• Integrazione con agenti di codifica AI. Ogni sito include un file AGENTS.md.
• Integrare Studio in script e fasi di build.

Installazione

1. Apri l’applicazione «WordPress Studio».
2. Dal menu principale, apri la finestra modale Impostazioni. Puoi anche fare clic sull’icona a forma di ingranaggio nell’angolo in alto a destra dell’app.
3. Abilita l’opzione «Studio CLI» e fai clic su Salva.
4. Su macOS, ti verrà richiesta la password del tuo account per consentire l’installazione.

Utilizzo

Studio CLI viene invocato con il comando studio. Tutti i comandi seguono lo schema:

studio <area> <command> [options]

Puoi visualizzare una panoramica generale in qualsiasi momento con:

studio --help

La maggior parte dei comandi è progettata per essere eseguita dalla directory principale di un sito gestito da Studio. Per specificare una directory del sito diversa dalla directory di lavoro corrente, utilizza l’opzione --path:

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

Comandi di autenticazione

Utilizza i comandi auth per gestire l’autenticazione WordPress.com per le funzionalità di Studio che richiedono un utente connesso (ad esempio, i siti di anteprima).

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 apre un flusso basato sul browser per collegare la CLI al tuo account WordPress.com. Riceverai un token di autenticazione da incollare nel terminale per completare il processo di accesso.
• studio auth status indica se sei attualmente autenticato e mostra quale account è in uso.
• studio auth logout disconnette la CLI dal tuo account WordPress.com e cancella le credenziali memorizzate.

Se esegui un comando che richiede l’autenticazione (come studio preview create) mentre sei disconnesso, la CLI restituirà un errore e ti guiderà ad effettuare l’accesso.

Usa il flag --help per visualizzare le opzioni dettagliate di qualsiasi comando di autenticazione:

studio auth --help
studio auth login --help

Comandi per i siti di anteprima

I siti di anteprima sono ambienti temporanei e condivisibili ospitati su WordPress.com che rispecchiano il tuo sito Studio locale. Usali per condividere il lavoro con colleghi o stakeholder senza richiedere un ambiente locale.

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

Creazione di un sito di anteprima

Dalla directory principale del tuo sito Studio locale:

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

Questo comando:

• Compilare e caricare il sito locale in un ambiente di anteprima.
• Restituire un URL di anteprima che puoi condividere con altri.
• Richiedere di essere connesso con studio auth login.

Puoi anche specificare esplicitamente una directory del sito:

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

Elencare i siti di anteprima

Per visualizzare tutti i siti di anteprima associati al tuo account:

studio preview list

Questo mostra l’host di ciascuna anteprima (ad esempio, example-preview.wpcomstaging.com), che utilizzerai con i comandi update e delete.

Aggiornare ed eliminare i siti di anteprima

Ogni sito di anteprima è identificato dal suo nome host:

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

Usa studio preview list per individuare il valore <host> appropriato se non lo hai a portata di mano.

Per l’elenco completo delle opzioni:

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

Comandi per la gestione dei siti locali

Usa i comandi site per gestire i siti Studio locali sul tuo computer: creazione, avvio, arresto, elenco e configurazione.

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

Creazione di un sito locale

Puoi eseguire il comando create da una directory vuota o da una directory che contiene già i file di un sito WordPress, purché non sia già presente nell’elenco di Studio.

Per creare un nuovo sito locale gestito da Studio:

# 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

Questo creerà un nuovo sito nella directory di lavoro corrente, avvierà il server WordPress e aprirà automaticamente wp-admin nel browser al termine dell’operazione.

Sono disponibili diversi flag supportati da utilizzare durante la creazione di un nuovo sito. Per l’elenco completo delle opzioni:

studio site create --help

Creare un sito locale utilizzando la Galleria dei Blueprint

Studio offre accesso alla Galleria dei Blueprint dove è possibile scegliere e attivare blueprint per creare un sito. La Galleria dei Blueprint è disponibile anche tramite CLI. I comandi per lavorare con i blueprint sono:

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

Elencare e ispezionare i siti

# 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

L’output dello stato include informazioni come:

• Se il sito è in esecuzione.
• URL locale (ad esempio, http://localhost:PORT).
• Dettagli chiave della configurazione (versione PHP, stato del database, ecc.).

Avvio e arresto dei siti

# 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

L’avvio di un sito lancerà i servizi locali necessari per accedervi tramite browser, mentre l’arresto spegnerà tali servizi.

Eliminazione di un sito locale

# Delete a site from Studio
studio site delete

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

Questo rimuove il sito da Studio e, facoltativamente, i file del sito dal disco.

Configurazione delle impostazioni del sito

Usa studio site set per modificare le impostazioni di un sito locale specifico.

studio site set [options]

Ecco alcuni esempi di utilizzo di questo comando:

• Modifica della versione di PHP o della versione di WordPress.
• Regolazione del dominio locale o della porta.
• Attivazione o disattivazione di funzionalità che influenzano il funzionamento dell’ambiente locale.

Per visualizzare l’elenco completo delle opzioni configurabili, esegui:

studio site set --help

Utilizzo di WP-CLI tramite Studio

Il comando studio wp ti consente di accedere a WP-CLI nel contesto di un sito gestito da Studio, senza dover installare o configurare WP-CLI separatamente.

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

Esempi (da eseguire dalla directory principale del sito):

# Check WordPress version:
studio wp core version

# List installed plugins:
studio wp plugin list

# Run database upgrades:
studio wp core update-db

Punti chiave:

• Non è necessaria un’installazione separata di WP-CLI; Studio lo fornisce e lo configura automaticamente.
• Le variabili d’ambiente, i percorsi e le credenziali vengono impostati automaticamente in base al sito selezionato, in modo che i comandi operino sul database e sui file corretti.
• Puoi utilizzare --path se non ti trovi nella directory del sito:

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

Per un elenco completo dei sottocomandi e degli argomenti WP-CLI supportati, consulta la documentazione WP-CLI oppure esegui:

studio wp help
studio wp help <command>

Utilizzo di Studio CLI con agenti di codifica AI

Studio CLI funziona bene con strumenti e agenti di sviluppo assistiti dall’AI come Claude Code, Cursor e altre estensioni IDE in grado di eseguire comandi shell per tuo conto.

Poiché questi strumenti possono visualizzare i file del tuo progetto ed eseguire comandi nel terminale, possono:

• Rilevare che stai lavorando in un progetto WordPress gestito da Studio.
• Chiamare automaticamente i comandi studio per gestire siti locali, anteprime e attività WP-CLI.
• Utilizzare l’output dei comandi per guidare ulteriori modifiche al codice o passaggi di debug.

Flussi di lavoro tipici con agenti AI

Di seguito sono riportati alcuni modi concreti per combinare Studio CLI con un agente di codifica AI.

1. Avviare e gestire un sito locale

Puoi istruire il tuo agente AI a creare e avviare un sito WordPress locale tramite Studio. Ad esempio, nel tuo editor:

«Configura un nuovo sito WordPress locale utilizzando la versione PHP 8.2 con Studio in questa cartella, avvialo e comunicami l’URL locale.»

Dietro le quinte, l’agente potrebbe eseguire:

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

Questo è utile quando:

• Stai prototipando rapidamente un nuovo plugin o tema.
• Ti stai inserendo in un progetto esistente e vuoi che l’agente configuri l’ambiente al posto tuo.

2. Debug automatizzato e operazioni WP-CLI

Quando l’agente suggerisce una correzione o una modifica, può anche eseguire verifiche utilizzando studio wp:

# Run database upgrades:
studio wp core update-db

# Check for current plugins:
studio wp plugin list

Potresti chiedere:

“Esegui tutti i controlli WP-CLI necessari tramite Studio per diagnosticare perché il sito restituisce un errore 500, poi proponi delle soluzioni.”

L’agente può iterativamente:

1. Eseguire comandi studio wp per raccogliere informazioni diagnostiche.
2. Aggiornare il codice o la configurazione.
3. Rieseguire i comandi per verificare la correzione.

3. Creazione e aggiornamento di siti di anteprima per la revisione

Gli agenti possono aiutarti a configurare e mantenere ambienti di anteprima collegati al tuo branch o alla tua funzionalità:

“Crea un sito di anteprima per questo progetto e forniscimi l’URL condivisibile. Poi, dopo ogni modifica al codice, aggiorna la stessa anteprima.”

Che si traduce in:

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

Questo è particolarmente utile quando:

• Condividere i progressi con stakeholder non tecnici.
• Collaborare con colleghi che hanno bisogno di vedere il comportamento dal vivo senza configurare un ambiente locale.

Best practice per l’utilizzo di agenti AI con Studio CLI

• Restare nella root di un sito Studio: Molti comandi presuppongono che la directory corrente sia un sito gestito da Studio. Ricorda al tuo agente di eseguire cd nella cartella corretta o di usare --path.
• Essere espliciti nelle istruzioni: Quando dai istruzioni a un agente, specifica “usa la CLI di studio” e qualsiasi vincolo, ad esempio:
  • «Non eliminare i siti esistenti.»
  • «Chiedi conferma prima di eseguire migrazioni del database.»
  • «Esegui solo comandi studio wp in sola lettura.»
• Verificare le operazioni distruttive: Comandi come studio site delete e studio preview delete possono rimuovere ambienti. Chiedi all’agente di mostrare i comandi che intende eseguire prima di lanciarli.
• Usare l’autenticazione in modo consapevole: Per i comandi che richiedono l’accesso a WordPress.com (studio auth login, studio preview ...), assicurati di essere a tuo agio con il fatto che l’agente avvii i flussi di accesso e conferma quale account viene utilizzato.

Combinando Studio CLI con agenti di coding AI, puoi delegare gran parte della configurazione ripetitiva degli ambienti, dei test e dell’orchestrazione del deployment, concentrandoti maggiormente sulla scrittura e la revisione del tuo codice WordPress.

Ottenere aiuto

Ogni comando e sottocomando supporta --help per la documentazione inline, l’utilizzo e le opzioni disponibili. Ad esempio:

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

Questo è il modo migliore per esplorare le funzionalità della versione specifica di Studio CLI che hai installato.