Studio CLI

Este texto fue traducido usando IA. Si deseas ver el texto original en inglés, haz clic aquí.

Studio CLI es una utilidad de línea de comandos disponible globalmente que te permite interactuar con las funciones de WordPress Studio desde tu terminal, independientemente de si Studio está abierto o no.

Es especialmente útil para:

• Gestionar sitios locales de Studio.
• Crear y actualizar sitios de vista previa en WordPress.com.
• Ejecutar comandos de WP-CLI.
• Integrar con agentes de codificación con IA. Cada sitio incluye un archivo AGENTS.md.
• Integrar Studio en scripts y pasos de compilación.

Instalación

1. Abre la aplicación «WordPress Studio».
2. Desde el menú principal, abre el modal de Ajustes. También puedes hacer clic en el icono de engranaje en la esquina superior derecha de la aplicación.
3. Habilita la opción «Studio CLI» y haz clic en Guardar.
4. En macOS, se te pedirá la contraseña de tu cuenta para permitir la instalación.

Uso

Studio CLI se invoca con el comando studio. Todos los comandos siguen el patrón:

studio <area> <command> [options]

Puedes ver una descripción general en cualquier momento con:

studio --help

La mayoría de los comandos están diseñados para ejecutarse desde el directorio raíz de un sitio gestionado por Studio. Para apuntar a un directorio de sitio diferente al directorio de trabajo actual, usa la opción --path:

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

Comandos de autenticación

Usa los comandos auth para gestionar tu autenticación de WordPress.com para las funciones de Studio que requieren un usuario con sesión iniciada (por ejemplo, sitios de vista previa).

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 abre un flujo en el navegador para conectar el CLI a tu cuenta de WordPress.com. Recibirás un token de autenticación para pegarlo en la terminal y completar el proceso de inicio de sesión.
• studio auth status informa si estás autenticado actualmente y muestra qué cuenta está en uso.
• studio auth logout desconecta el CLI de tu cuenta de WordPress.com y elimina las credenciales almacenadas.

Si ejecutas un comando que requiere autenticación (como studio preview create) mientras no has iniciado sesión, la CLI devolverá un error y te guiará para iniciar sesión.

Usa la opción --help para ver las opciones detalladas de cualquier comando de autenticación:

studio auth --help
studio auth login --help

Comandos de sitios de vista previa

Los sitios de vista previa son entornos temporales y compartibles alojados en WordPress.com que reflejan tu sitio local de Studio. Úsalos para compartir trabajo con compañeros de equipo o partes interesadas sin necesidad de un entorno local.

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

Crear un sitio de vista previa

Desde la raíz de tu sitio local de Studio:

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

Esto hará lo siguiente:

• Compilar y subir tu sitio local a un entorno de vista previa.
• Devolver una URL de vista previa que puedes compartir con otros.
• Requiere que hayas iniciado sesión con studio auth login.

También puedes especificar un directorio de sitio de forma explícita:

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

Listar sitios de vista previa

Para ver todos los sitios de vista previa asociados con tu cuenta:

studio preview list

Esto muestra el host de cada vista previa (por ejemplo, example-preview.wpcomstaging.com), que utilizarás con los comandos update y delete.

Actualizar y eliminar sitios de vista previa

Cada sitio de vista previa se identifica por su nombre de 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 para descubrir el valor apropiado de <host> si no lo tienes a mano.

Para ver el conjunto completo de opciones:

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

Comandos de gestión de sitios locales

Usa los comandos site para gestionar los sitios locales de Studio en tu máquina: crearlos, iniciarlos, detenerlos, listarlos y configurarlos.

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

Crear un sitio local

Puedes ejecutar el comando create desde un directorio vacío, o desde un directorio que ya contenga los archivos de un sitio WordPress, pero que aún no esté listado en Studio.

Para crear un nuevo sitio local gestionado por 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

Esto creará un nuevo sitio en tu directorio de trabajo actual, iniciará el servidor de WordPress y abrirá wp-admin en tu navegador automáticamente cuando termine.

Hay varias opciones compatibles que puedes usar al crear un nuevo sitio. Para ver el conjunto completo de opciones:

studio site create --help

Crear un sitio local usando la Galería de Blueprints

Studio ofrece acceso a la Galería de Blueprints donde puedes elegir y activar blueprints para crear un sitio. La Galería de Blueprints también está disponible a través de CLI. Los comandos para trabajar con blueprints son:

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

Listar e inspeccionar sitios

# 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

La salida de estado incluye información como:

• Si el sitio está en ejecución.
• URL local (por ejemplo, http://localhost:PORT).
• Detalles clave de configuración (versión de PHP, estado de la base de datos, etc.).

Iniciar y detener sitios

# 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

Iniciar un sitio lanzará los servicios locales necesarios para acceder a él en un navegador, mientras que detenerlo apagará esos servicios.

Eliminar un sitio local

# Delete a site from Studio
studio site delete

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

Esto elimina el sitio de Studio y, opcionalmente, los archivos del sitio del disco.

Configurar los ajustes del sitio

Usa studio site set para ajustar la configuración de un sitio local específico.

studio site set [options]

Algunos ejemplos de para qué se puede usar este comando incluyen:

• Cambiar la versión de PHP o la versión de WordPress.
• Ajustar el dominio local o el puerto.
• Activar o desactivar funciones que afectan el funcionamiento del entorno local.

Para ver la lista completa de opciones configurables, ejecuta:

studio site set --help

Usar WP-CLI a través de Studio

El comando studio wp te da acceso a WP-CLI dentro del contexto de un sitio gestionado por Studio, sin necesidad de instalar o configurar WP-CLI por separado.

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

Ejemplos (ejecutados desde el directorio raíz de tu sitio):

# Check WordPress version:
studio wp core version

# List installed plugins:
studio wp plugin list

# Run database upgrades:
studio wp core update-db

Puntos clave:

• No necesitas una instalación separada de WP-CLI; Studio lo proporciona y configura por ti.
• Las variables de entorno, rutas y credenciales se configuran automáticamente en función del sitio seleccionado, de modo que los comandos operan sobre la base de datos y los archivos correctos.
• Puedes usar --path si no estás en el directorio del sitio:

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

Para obtener una lista completa de los subcomandos y argumentos de WP-CLI compatibles, consulta la documentación de WP-CLI o ejecuta:

studio wp help
studio wp help <command>

Uso de Studio CLI con agentes de programación con IA

Studio CLI funciona bien con herramientas y agentes de desarrollo asistidos por IA como Claude Code, Cursor y otras extensiones de IDE que pueden ejecutar comandos de terminal en tu nombre.

Dado que estas herramientas pueden ver los archivos de tu proyecto y ejecutar comandos de terminal, pueden:

• Detectar que estás trabajando en un proyecto de WordPress gestionado por Studio.
• Ejecutar comandos de studio automáticamente para gestionar sitios locales, vistas previas y tareas de WP-CLI.
• Utilizar la salida de los comandos para guiar cambios de código adicionales o pasos de depuración.

Flujos de trabajo típicos con agentes de IA

A continuación se muestran algunas formas concretas de combinar Studio CLI con un agente de programación con IA.

1. Crear y gestionar un sitio local

Puedes indicarle a tu agente de IA que cree y ejecute un sitio local de WordPress a través de Studio. Por ejemplo, en tu editor:

«Configura un nuevo sitio local de WordPress usando la versión de PHP 8.2 con Studio en esta carpeta, inícialo y dime la URL local.»

Detrás de escena, el agente podría ejecutar:

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

Esto es útil cuando:

• Estás creando rápidamente un prototipo de un nuevo plugin o tema.
• Te incorporas a un proyecto existente y quieres que el agente configure el entorno por ti.

2. Depuración automatizada y operaciones con WP-CLI

Cuando el agente sugiere una corrección o un cambio, también puede ejecutar comprobaciones usando studio wp:

# Run database upgrades:
studio wp core update-db

# Check for current plugins:
studio wp plugin list

Podrías preguntar:

«Ejecuta las comprobaciones de WP-CLI que necesites a través de Studio para diagnosticar por qué el sitio está devolviendo un error 500 y luego propón soluciones.»

El agente puede de forma iterativa:

1. Ejecutar comandos studio wp para recopilar diagnósticos.
2. Actualizar código o configuración.
3. Volver a ejecutar comandos para verificar la corrección.

3. Crear y actualizar sitios de vista previa para revisión

Los agentes pueden ayudarte a configurar y mantener entornos de vista previa vinculados a tu rama o funcionalidad:

«Crea un sitio de vista previa para este proyecto y dame la URL para compartir. Luego, después de cada cambio de código, actualiza la misma vista previa.»

Lo que se traduce en:

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

Esto es particularmente útil cuando:

• Compartir el progreso con partes interesadas no técnicas.
• Colaborar con compañeros de equipo que necesitan ver el comportamiento en vivo sin configurar un entorno local.

Mejores prácticas al usar agentes de IA con Studio CLI

• Permanece en la raíz de un sitio de Studio: Muchos comandos asumen que el directorio actual es un sitio gestionado por Studio. Recuerda a tu agente que use cd para entrar en la carpeta correcta o que utilice --path.
• Sé explícito en las instrucciones: Al dar indicaciones a un agente, menciona «usa el CLI de studio» y cualquier restricción, por ejemplo:
  • «No elimines sitios existentes.»
  • «Pide confirmación antes de ejecutar migraciones de base de datos.»
  • «Solo ejecuta comandos de studio wp de solo lectura.»
• Revisa las operaciones destructivas: Comandos como studio site delete y studio preview delete pueden eliminar entornos. Pide al agente que muestre los comandos que planea ejecutar antes de ejecutarlos.
• Usa la autenticación de forma deliberada: Para los comandos que requieren acceso a WordPress.com (studio auth login, studio preview ...), asegúrate de que te sientes cómodo con que el agente inicie flujos de inicio de sesión, y confirma qué cuenta se está utilizando.

Al combinar Studio CLI con agentes de codificación con IA, puedes delegar gran parte de la configuración repetitiva del entorno, las pruebas y la orquestación del despliegue, y centrarte más en escribir y revisar tu código de WordPress.

Obtener ayuda

Cada comando y subcomando admite --help para documentación en línea, uso y opciones disponibles. Por ejemplo:

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

Esta es la mejor manera de explorar las capacidades de la versión específica de Studio CLI que tienes instalada.