Si llevas tiempo desarrollando con WordPress, es muy probable que en algún momento hayas utilizado WP-CLI. Desde instalar una nueva instancia hasta actualizar plugins, realizar búsquedas y reemplazos en la base de datos o automatizar despliegues, WP-CLI se ha convertido en una de las herramientas más importantes para desarrolladores, agencias y proveedores de hosting.
Yo lo utilizo prácticamente todos los días. Forma parte de mis scripts de despliegue, tareas de mantenimiento, procesos de migración y de varias herramientas que estoy desarrollando alrededor de WordPress.
Precisamente por eso empecé a notar algo que me llamó la atención.
Mucho más que un conjunto de comandos
Cuando pensamos en WP-CLI solemos imaginar comandos como:
wp plugin update --all
wp search-replace
wp db export
Pero, en realidad, WP-CLI es muchísimo más que eso.
Incluye decenas de familias de comandos para administrar prácticamente cualquier aspecto de WordPress: el núcleo, plugins, temas, usuarios, la base de datos, medios, comentarios, menús, widgets, cron, idiomas, multisite, configuración y mucho más.
Además, muchas de estas funcionalidades se distribuyen en paquetes oficiales independientes, lo que hace que el ecosistema sea todavía más amplio.
El problema es que descubrir todo ese potencial no siempre es sencillo.
La información está distribuida
La documentación oficial de WP-CLI es excelente y cumple perfectamente su propósito: explicar cómo funciona cada comando.
Sin embargo, cuando quieres responder preguntas como:
- ¿Qué comandos existen para administrar usuarios?
- ¿Qué operaciones puedo realizar sobre la base de datos?
- ¿Qué comandos pertenecen a cada paquete?
- ¿Qué opciones admite un determinado comando?
- ¿Qué otras operaciones relacionadas existen?
La información deja de estar en un solo lugar.
Es habitual terminar navegando entre:
- La documentación oficial.
- El repositorio principal de WP-CLI.
- Los distintos paquetes oficiales en GitHub.
- La ayuda integrada (
wp help). - El código fuente de algunos comandos.
Nada de eso está mal. Es simplemente el resultado natural de un proyecto que ha evolucionado durante muchos años.
Pero, cuando necesitas explorar el ecosistema completo, ese proceso termina siendo más lento de lo que debería.
Cambió la forma en que usamos WP-CLI
Hace algunos años, la mayoría utilizábamos WP-CLI para ejecutar comandos puntuales desde la terminal.
Hoy la realidad es diferente.
WP-CLI forma parte de:
- Scripts de automatización.
- Plataformas de hosting.
- Herramientas para agencias.
- Procesos de CI/CD.
- Sistemas de despliegue.
- Integraciones con otras aplicaciones.
- Herramientas impulsadas por IA.
En todos esos escenarios es cada vez más útil disponer de una referencia que permita descubrir rápidamente qué comandos existen y cómo se relacionan entre sí.
Un mismo comando, distintos entornos
Otra funcionalidad especialmente útil son los aliases de WP-CLI.
Los aliases permiten identificar distintas instalaciones o entornos de WordPress con nombres como @local, @staging o @production. De esta forma, el mismo comando puede ejecutarse sobre diferentes sitios sin tener que conectarse manualmente a cada servidor:
wp @staging plugin list
wp @production core version
También es posible agrupar varios aliases para ejecutar una operación sobre múltiples instalaciones.
Esta capacidad resulta especialmente interesante para agencias, proveedores de hosting y herramientas de automatización. También facilita el trabajo con agentes de IA, porque permite indicar con claridad sobre qué entorno debe actuar cada comando.
Naturalmente, el acceso a entornos remotos debe acompañarse de reglas de seguridad claras: utilizar operaciones de solo lectura por defecto, probar primero los comandos que admitan --dry-run y exigir confirmación antes de modificar producción.
Los aliases son un buen ejemplo de cómo WP-CLI no solo sirve para administrar WordPress desde una terminal, sino también como interfaz común entre distintas instalaciones, automatizaciones y herramientas.
La documentación oficial explica cómo ejecutar comandos remotamente y configurar aliases. Brian Coords también ha publicado un artículo interesante sobre cómo utilizar los aliases de WP-CLI con agentes de programación.
La referencia que me hacía falta
Mientras desarrollaba varias herramientas relacionadas con WordPress, me encontré haciendo siempre las mismas preguntas:
- ¿Existe ya un comando para esto?
- ¿Qué paquete lo implementa?
- ¿Cuál es exactamente su sintaxis?
- ¿Qué opciones admite?
- ¿Existe algún otro comando relacionado?
Cada vez terminaba recorriendo las mismas páginas de documentación.
Entonces pensé que probablemente no era el único.
Lo que necesitaba no era reemplazar la documentación oficial.
Lo que necesitaba era una referencia que me permitiera explorar WP-CLI de una forma mucho más cómoda.
Así nació este proyecto
Con esa idea en mente decidí crear una referencia completa de WP-CLI.
No pretende sustituir la documentación oficial.
De hecho, cada comando enlaza a su documentación correspondiente.
El objetivo es ofrecer una forma más cómoda de descubrir el ecosistema de WP-CLI desde un único lugar.
Actualmente incluye:
- Todas las familias de comandos oficiales.
- Sus subcomandos.
- Argumentos.
- Opciones disponibles.
- Ejemplos de uso.
- Enlaces a la documentación oficial.
- Enlaces al código fuente cuando corresponde.
- Navegación organizada.
- Búsqueda rápida.
En lugar de ir saltando entre varias páginas o repositorios, la idea es poder encontrar la información necesaria en cuestión de segundos.
Un proyecto que seguirá creciendo
Aunque el sitio ya es completamente funcional, quiero seguir ampliándolo.
Me gustaría incorporar más ejemplos, mejorar la navegación, añadir referencias cruzadas entre comandos y convertirlo en una herramienta cada vez más útil para quienes trabajamos con WordPress desde la terminal.
Si utilizas WP-CLI con frecuencia, espero que también te resulte útil.
Puedes explorarlo aquí:
https://wp-cli.oscarhugopaz.com
Y si encuentras algún error, echas en falta algún comando o tienes alguna sugerencia, estaré encantado de recibir tus comentarios.
Únete a mi círculo
Si quieres leer publicaciones sobre temas avanzados de WordPress y Gutenberg aprender a crear sitios web profesionales con WordPress, puedes registrarte en mi círculo y acceder a más contenido premium.
Deja una respuesta