Studio CLI

Studio CLI es una utilidad de línea de comandos disponible de forma global que te permite interactuar con las funcionalidades de WordPress Studio desde tu terminal, tanto si Studio está abierto como si no.

Resulta especialmente útil para:

• Gestionar sitios locales de Studio.
• Crear y actualizar sitios de vista previa en WordPress.com.
• Ejecutar comandos de WP-CLI.
• Integrarse con agentes de IA para programar. 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. En el menú principal, abre la ventana Settings (Ajustes). También puedes hacer clic en el icono del engranaje situado en la esquina superior derecha de la aplicación.
3. Activa la opción «Studio CLI» y haz clic en Save (Guardar).
4. En macOS, se te pedirá la contraseña de tu cuenta para autorizar la instalación.

Uso

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

studio <area> <command> [options]

En cualquier momento puedes ver un resumen general 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 distinto del directorio de trabajo actual, utiliza la opción --path:

studio <area> <command> --path /ruta/al/sitio

Comandos de autenticación

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

studio auth login      # Iniciar sesión en WordPress.com
studio auth logout     # Cerrar sesión y borrar la autenticación de WordPress.com
studio auth status     # Consultar el estado de autenticación

• studio auth login abre un flujo basado en el navegador para conectar la CLI con tu cuenta de WordPress.com. Recibirás un token de autenticación que deberás pegar en el terminal para completar el inicio de sesión.
• studio auth status informa de si tienes la sesión iniciada en ese momento y muestra qué cuenta se está utilizando.
• studio auth logout desconecta la CLI de tu cuenta de WordPress.com y borra las credenciales almacenadas.

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

Utiliza la opción --help para ver información detallada sobre 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 el trabajo con compañeros de equipo o partes interesadas sin necesidad de un entorno local.

studio preview create          # Crear un sitio de vista previa
studio preview list            # Listar los sitios de vista previa
studio preview update <host>   # Actualizar un sitio de vista previa existente
studio preview delete <host>   # Eliminar un sitio de vista previa

Crear un sitio de vista previa

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

cd /ruta/a/tu/sitio-de-studio
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 podrás compartir con otras personas.
• Requerirá 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 /ruta/a/tu/sitio-de-studio

Listar sitios de vista previa

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

studio preview list

Esto muestra el host de cada vista previa (por ejemplo, ejemplo-vista-previa.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:

# Recompilar y volver a desplegar los cambios de tu sitio local en el sitio de vista previa:
studio preview update <host>

# Eliminar un sitio de vista previa de forma permanente:
studio preview delete <host>

Utiliza studio preview list para localizar el valor de <host> que necesites 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

Utiliza los comandos site para gestionar los sitios locales de Studio en tu equipo: crearlos, iniciarlos, detenerlos, listarlos y configurarlos.

studio site status    # Consultar el estado del sitio local
studio site create    # Crear un nuevo sitio local
studio site list      # Listar los sitios locales
studio site start     # Iniciar un sitio local
studio site stop      # Detener sitios locales
studio site delete    # Eliminar un sitio local
studio site set       # Configurar los ajustes del sitio

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, siempre que no esté ya incluido en Studio.

Para crear un nuevo sitio local gestionado por Studio:

# Crear un nuevo sitio en el directorio de trabajo actual con todas las opciones por defecto
studio site create

# Crear un nuevo sitio con un dominio personalizado y HTTPS
studio site create --https --domain hello.wp.local

# Crear un nuevo sitio en un directorio diferente
studio site create --path /ruta/al/sitio

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 al finalizar.

Hay varios parámetros compatibles que puedes utilizar al crear un nuevo sitio. Para ver el conjunto completo de opciones:

studio site create --help

Listar e inspeccionar sitios

# Mostrar todos los sitios locales conocidos por Studio:
studio site list

# Mostrar los detalles y el estado actual del sitio en el directorio actual:
studio site status

# O explícitamente para una ruta concreta:
studio site status --path /ruta/al/sitio

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

# Desde dentro del directorio de un sitio:
studio site start
studio site stop

# O por ruta:
studio site start --path /ruta/al/sitio
studio site stop --path /ruta/al/sitio

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

Eliminar un sitio local

# Eliminar un sitio de Studio
studio site delete

# Eliminar el sitio y mover el directorio del sitio a la papelera del sistema
studio site delete --files

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

Configurar los ajustes del sitio

Utiliza studio site set para modificar los ajustes de un sitio local concreto.

studio site set [options]

Algunos ejemplos de lo que permite hacer este comando:

• Cambiar la versión de PHP o la versión de WordPress.
• Ajustar el dominio o el puerto locales.
• Activar o desactivar funcionalidades que afectan al 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 ni configurar WP-CLI por separado.

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

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

# Consultar la versión de WordPress:
studio wp core version

# Listar los plugins instalados:
studio wp plugin list

# Ejecutar las actualizaciones de la base de datos:
studio wp core update-db

Puntos clave:

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

  studio wp plugin list --path /ruta/al/sitio

Para consultar la lista completa de subcomandos y argumentos de WP-CLI admitidos, consulta la documentación de WP-CLI o ejecuta:

studio wp help
studio wp help <command>

Usar Studio CLI con agentes de IA para programar

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

Como estas herramientas pueden ver los archivos de tu proyecto y ejecutar comandos del terminal, pueden:

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

Flujos de trabajo habituales con agentes de IA

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

1. Crear y gestionar un sitio local

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

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

Entre bambalinas, el agente podría ejecutar:

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

Esto resulta útil cuando:

• Prototipas rápidamente un nuevo plugin o tema.
• Te incorporas a un proyecto existente y quieres que el agente te prepare el entorno.

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

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

# Ejecutar actualizaciones de la base de datos:
studio wp core update-db

# Comprobar los plugins actuales:
studio wp plugin list

Podrías pedirle:

«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 propón soluciones.»

El agente puede, de forma iterativa:

1. Ejecutar comandos studio wp para recopilar diagnósticos.
2. Actualizar el código o la configuración.
3. Volver a ejecutar los comandos para comprobar 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 asociados a tu rama o funcionalidad:

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

Lo que se traduce en:

studio auth login              # si hace falta
studio preview create          # despliegue inicial
studio preview update <host>   # tras los cambios posteriores

Esto resulta especialmente útil cuando:

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

Buenas 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. Recuérdale a tu agente que haga cd a la carpeta correcta o que utilice --path.
• Sé explícito en las instrucciones: al dirigirte a un agente, menciona «usa la CLI de studio» y cualquier restricción, por ejemplo:
  • «No elimines sitios existentes.»
  • «Pide confirmación antes de ejecutar migraciones de base de datos.»
  • «Ejecuta solo comandos 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 tiene previsto ejecutar antes de hacerlo.
• Utiliza la autenticación de forma consciente: 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 los flujos de inicio de sesión, y confirma qué cuenta se está utilizando.

Al combinar Studio CLI con agentes de IA para programar, 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 mostrar documentación, uso y opciones disponibles en línea. 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 forma de explorar las capacidades de la versión concreta de Studio CLI que tengas instalada.