WordPress Studio 1.7.0: conoce la nueva CLI de Studio

La versión 1.7.0 de WordPress Studio es una actualización importante para aquellos interesados en crear sitios de WordPress localmente, especialmente desarrolladores y usuarios avanzados a los que les gusta automatizar tareas y trabajar desde el terminal.

En las versiones anteriores, la CLI de Studio se centraba principalmente en crear y gestionar sitios de vista previa. 

Con la segunda versión, se convierte en un complemento integral de la línea de comandos que puedes utilizar para una gran parte de tu flujo de trabajo en Studio, como la creación y gestión de sitios locales, la ejecución de WP-CLI en el contexto adecuado, la conexión a WordPress.com y mucho más.

En este artículo, analizaremos todas las novedades y también veremos formas prácticas de incorporar la CLI de Studio en procesos de trabajo asistidos por IA. 

Si necesitas echarle un vistazo a todas las referencias de los comandos y las opciones avanzadas, consulta la documentación de Studio CLI.

¿Qué es una CLI?

La CLI (interfaz de línea de comandos, por sus siglas en inglés) te permite controlar herramientas y aplicaciones escribiendo comandos en un terminal en lugar de andar navegar por los menús. A los desarrolladores suelen gustarles las CLI porque son:

• Rápidas: creas, modificas o eliminas entornos con un solo comando.
• Repetibles: puedes ejecutar los mismos comandos en cualquier máquina o integrarlos en scripts.
• Automatizables: permite que los sistemas de compilación y los agentes de IA ejecuten comandos por ti.

Incluso si no sueles trabajar en el terminal, puede que te merezca la pena echarle un vistazo a la CLI de Studio. 

Funciona de forma parecida a un idioma común que las herramientas de automatización pueden utilizar para interactuar con Studio. Una vez habilitada, tu editor, los scripts o asistentes de programación con IA pueden hacer todo tipo de cosas, como crear un nuevo sitio, ejecutar actualizaciones de la base de datos o publicar una vista previa sin que tengas que navegar por varias pantallas en la aplicación Studio.

Primeros pasos con la CLI de Studio

Para empezar a usar la CLI de Studio, sigue los siguientes pasos:

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

Una vez habilitada la CLI de Studio, tendrás acceso al comando global studio desde tu aplicación de terminal preferida:

studio <area> <command> [options]

En Studio 1.7.0, puedes usar la CLI en cuatro áreas principales:

• Autenticación: gestiona tu cuenta de WordPress.com para las funciones que lo requieran.
• Sitios de vista previa: crea y actualiza sitios de vista previa alojados en WordPress.com.
• Gestión de sitios locales: crea, inicia, detén, configura y elimina sitios locales gestionados por Studio.
• Integración con WP-CLI: ejecuta comandos de WP-CLI dentro de entornos de Studio correctamente configurados, sin necesidad de instalar WP-CLI.

Puedes ver un resumen general en cualquier momento ejecutando studio --help:

La mayoría de los comandos están diseñados para ejecutarse desde la carpeta raíz de un sitio gestionado por Studio. 

Para acceder directamente, abre directamente ese directorio en tu terminal haciendo clic en el botón Terminal en la pestaña General del sitio.

Gestión de sitios locales de Studio

Una de las mejoras más importantes en la segunda versión de la CLI de Studio es la gestión integral de sitios locales desde el terminal. 

En lugar de volver continuamente a la interfaz de usuario de Studio para hacer tareas rutinarias, puedes crear un sitio, comprobar su estado, iniciarlo o detenerlo y eliminarlo cuando hayas terminado. 

Es una forma de trabajar mucho más rápido para el día a día, y también hace que la automatización sea mucho más sencilla, tanto si escribes los scripts tú mismo como si utilizas un agente de IA para que los haga por ti.

El centro neurálgico es el comando studio site. Estas son las opciones disponibles:

studio site status    # Obtiene el estado del sitio
studio site create    # Crea un nuevo sitio
studio site list      # Lista los sitios
studio site start     # Inicia un sitio
studio site stop      # Detiene uno o varios sitios
studio site delete    # Elimina un sitio
studio site set       # Configura los ajustes del sitio

Crear sitios locales con un solo comando

Utiliza studio site create para crear un nuevo sitio en el directorio actual o en una ruta específica. Aquí tienes algunos ejemplos de lo que puedes hacer:

# Crear un nuevo sitio con las opciones predeterminadas en la carpeta actual
studio site create
# Crear un nuevo sitio con un dominio personalizado y HTTPS
studio site create --https --domain hola.wp.local
# Crear un sitio en un directorio diferente
studio site create --path /ruta/al/sitio

La CLI se encargará de:

• Configurar un entorno de WordPress local.
• Iniciar el servidor de WordPress.
• Abrir el WP Admin en tu navegador cuando esté listo.

Puedes ejecutarlo desde una carpeta vacía o desde un directorio que contenga un sitio de WordPress que todavía no esté registrado en la aplicación Studio.

Listar, inspeccionar, iniciar y detener sitios locales

Los comandos list y status te pueden facilitan mucho la gestión si trabajas con varios sitios locales:

studio site list       # Muestra todos los sitios locales conocidos por Studio
studio site status     # Estado del sitio en el directorio actual

Las opciones de estado pueden ser:

• Si el sitio está en funcionamiento.
• La URL local, por ejemplo http://localhost:PUERTO.
• Detalles clave de los ajustes, como la versión de PHP y la información de inicio de sesión.

Iniciar y detener sitios también es sencillo:

studio site start      
studio site stop

Funciona muy bien en scripts que necesitan iniciar un sitio, ejecutar pruebas u operaciones de contenido y luego detenerlo de nuevo.

Eliminar y configurar sitios de forma segura

Cuando hayas terminado con un proyecto, puedes eliminarlo de Studio y, si es necesario, eliminar todos los archivos asociados de tu equipo con los siguientes comandos:

studio site delete          # Elimina el sitio de Studio
studio site delete --files  # Elimina el sitio y los archivos

Para hacer cambios en la configuración, studio site set te permite ajustar la configuración de un sitio local específico:

studio site set [options]

Por ejemplo, puedes:

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

Consejo: ejecuta studio site set --help para ver la lista completa de las opciones disponibles.

Autenticación desde el terminal

Algunas funciones de Studio, como crear o actualizar sitios de vista previa, requieren una cuenta de WordPress.com con una sesión iniciada. 

La segunda versión de la CLI de Studio incluye los comandos studio auth para que puedas gestionarlo desde el terminal:

• studio auth login inicia un flujo en el navegador y te proporciona un token para pegarlo en tu terminal y completar el inicio de sesión.
• studio auth status te indica si estás autenticado y qué cuenta está activa.
• studio auth logout desconecta la CLI de tu cuenta de WordPress.com y borra las credenciales almacenadas.

Si ejecutas un comando que necesita autenticación mientras no tienes la sesión iniciada, como, por ejemplo, studio preview create (que veremos más abajo), la CLI te guiará para iniciar sesión.

Sitios de vista previa desde la CLI

Los sitios de vista previa son entornos temporales alojados en WordPress.com ideales para compartir, ya que son un reflejo de tu sitio local de Studio. Son muy prácticos para compartir tu trabajo con otras personas que no tienen un entorno local.

La CLI proporciona un amplio abanico de comandos:

studio preview create          # Crea un sitio de vista previa
studio preview list            # Lista todos tus sitios de vista previa
studio preview update <host>   # Vuelve a desplegar los cambios en una vista previa
studio preview delete <host>   # Elimina un sitio de vista previa

Consejo: ejecuta studio preview list para ver todas las vistas previas asociadas a tu cuenta de WordPress.com, y utiliza el valor del host del resultado con studio preview update o studio preview delete.

WP-CLI integrada, configurada para ti

WP-CLI es la interfaz oficial de línea de comandos de WordPress. La segunda versión de Studio CLI la integra directamente mediante el comando dedicado studio wp, por lo que no es necesario instalar ni configurar WP-CLI en tu equipo:

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

Desde el directorio raíz de tu sitio, puedes ejecutar tareas comunes de WP-CLI como:

• studio wp core version muestra la versión de WordPress del sitio actual.
• studio wp plugin list muestra los plugins instalados (y su estado).
• studio wp core update-db ejecuta las actualizaciones necesarias de la base de datos tras una actualización de WordPress.

Studio configura las variables del entorno, las rutas y las credenciales por ti, por lo que estos comandos se ejecutan en la base de datos y en los archivos correctos sin que tengas que hacer nada más.

Uso de la CLI de Studio con herramientas de programación con IA

Una de las mayores ventajas de la segunda versión de la CLI de Studio es lo bien que encaja en los flujos de trabajo de desarrollo asistidos por IA, especialmente con herramientas como Claude Code y Cursor. 

Estos agentes leen el código de tu proyecto local (incluidos temas y plugins) y ejecutan comandos en tu entorno, lo que hace posible delegar gran parte del trabajo repetitivo. Por ejemplo, pueden:

• Usar comandos studio site para crear, iniciar, detener y gestionar entornos locales.
• Ejecutar studio wp para diagnósticos, tareas de la base de datos y gestión de contenido.
• Crear y actualizar sitios de vista previa de WordPress.com para su revisión sin salir del editor.

Proporcionar contexto

Es posible que la herramienta de IA que estés utilizando no se entienda automáticamente con WordPress Studio o con la CLI de Studio. Para que los resultados sean útiles, primero debes darle al agente de IA un poco de contexto sobre lo que está viendo y qué herramientas puede usar.

Por ejemplo, imagina que has abierto una carpeta de un sitio local de Studio en tu terminal. 

Empieza diciéndole al agente de IA qué es este directorio y que puede ejecutar la CLI de Studio. 

En este ejemplo, usaremos Claude Code y indicaremos explícitamente que puede invocar la CLI mediante el comando studio.

«Esta es la carpeta de un sitio de WordPress Studio. Tienes acceso a la CLI de Studio, que se puede invocar ejecutando studio. Empieza por explorar las opciones disponibles».

Con esto, deberías obtener una respuesta similar a esta:

Con unas sencillas instrucciones, la IA ahora tiene un mejor entendimiento de la CLI de Studio. Este ejemplo se ha generado con Opus 4.5.

Automatizar la configuración del entorno

Una vez que la IA comprende lo que puede hacer Studio, puedes empezar a delegar tareas de configuración rutinarias. Por ejemplo, podrías decirle a tu agente:

«Configura un nuevo sitio de WordPress local con Studio con el nombre «Sitio de Nick»».

En segundo plano, puede ejecutar algo como:

studio site create --path "../sitio-de-nick" --name "Sitio de Nick" --skip-browser

Este es un ejemplo de un resultado de Claude Code, también usando Opus 4.5.

Solución de errores y verificación con WP-CLI

Con Studio también es muy sencillo solucionar problemas mediante WP-CLI, sobre todo cuando te encuentras con un error y no quieres buscar la causa de forma manual.

Podrías decir:

«Usa la CLI de Studio para ejecutar comprobaciones con WP-CLI y averiguar por qué está fallando este sitio. Después, sugiere algunas soluciones».

Con esto, el agente puede:

• Ejecutar comandos studio wp (por ejemplo, plugin list, theme list o core update-db) para recopilar diagnósticos.
• Sugerir (o aplicar) cambios en el código y la configuración basándose en lo que encuentre.
• Volver a ejecutar las mismas comprobaciones con WP-CLI para confirmar que el problema está resuelto.

Si no lo has hecho ya, échale un vistazo a este resumen de la WP-CLI para hacerte una idea de todo lo que puede hacer.

Crear sitios de vista previa

Los sitios de vista previa son una de las funciones más populares de WordPress Studio, pero crearlos y mantenerlos actualizados puede resultar un poco tedioso si lo haces con la interfaz de usuario de Studio. 

La CLI simplifica el trabajo, y es aún más sencillo al combinarlo con un agente de IA.

Cuando todo esté preparado para compartirlo con un cliente o con un compañero de equipo, solo tienes que pedirle a tu IA que cree un sitio de vista previa:

«¿Puedes crear un sitio de vista previa?».

Si tu cuenta todavía no está conectada, el agente te pedirá que inicies sesión; después creará el sitio de vista previa y te responderá con la URL. El resultado debería ser algo parecido a esto:

Si sigues trabajando en el sitio de forma local, puedes pedirle periódicamente al agente que actualice el sitio de vista previa. 

Si también estás usando la IA para ayudar a construir el sitio, el tema o el plugin, puedes incluso añadir una regla del tipo: después de cualquier cambio importante, actualiza el sitio de vista previa automáticamente para que el enlace compartido refleje los nuevos cambios.

Consejos al utilizar la IA con la CLI de Studio

Los agentes de IA pueden ser unos compañeros muy efectivos al combinarlos con la CLI de Studio. Te ayudan a acelerar la configuración, la resolución de problemas, los despliegues de los sitios de vista previa y la ejecución de comandos reales en tu entorno. 

Dicho esto, un poco de estructura al principio siempre viene bien, y a la vez te puedes evitar alguna sorpresa desagradable.

• Trabaja desde la raíz del sitio de Studio (o usa `--path`). Esto garantiza que los comandos se ejecuten en el proyecto que realmente quieres, especialmente si tienes varios sitios en tu equipo.
• Establece límites claros en tus peticiones. Por ejemplo: «No elimines sitios», «Ejecuta solamente comandos studio wp de solo lectura» o «Pregunta antes de ejecutar migraciones de la base de datos».
• Revisa bien las operaciones destructivas. En comandos como studio site delete y studio preview delete, haz que el agente te muestre los comandos exactos que planea ejecutar antes de ejecutar nada.

Si los usas con cabeza, la IA junto con la CLI de Studio se pueden encargar de muchas tareas tediosas y repetitivas de configuración, pruebas y despliegue, de forma que tú puedas concentrarte más en diseñar y crear increíbles experiencias con WordPress.

Empieza a crear con la CLI de Studio

La segunda versión de la CLI de Studio hace que WordPress Studio sea mucho más programable y automatizable de cara al trabajo diario, tanto si ejecutas los comandos con tus propias manos como si trabajas con un agente de IA.

Si quieres profundizar más, en la documentación de la CLI de Studio se explica todo lo que puedes hacer y cómo integrarlo en tus procesos de trabajo.

Si todavía no has probado WordPress Studio o hace un tiempo que no lo usas, este es un buen momento para empezar. Descarga Studio, crea un sitio y prueba la CLI actualizada.