Plak CLI

Instala Plak CLI, crea sitios locales, usa el dashboard, prepara sitios para agentes y conecta tu máquina al panel.

Plak CLI es una herramienta Bash con interfaz interactiva mediante gum para el trabajo local con WordPress: sitios servidos con FrankenPHP/Caddy, remotos SSH y migraciones, con conexión opcional a tu cuenta del panel. Cada sitio puede nacer agent-ready (WP-MCP + wp-mcp-cli) para que un asistente lo opere por MCP.

Comprobado con Plak CLI v0.4.66

La CLI es la fuente de verdad de sus comandos: cada ejemplo de esta sección coincide con plak <comando> --help en esa versión.

Qué es cada cosa

Si es tu primera vez, estos cuatro conceptos lo explican todo:

Sitio local: un WordPress (o un estático) en ~/Plak/Sites/<nombre>.localhost, servido por tu máquina con HTTPS local. Se crea con plak add, se ve con plak list y se opera desde el dashboard o la terminal.
Dashboard: la página https://plak.localhost para ver y operar tus sitios con botones (plugins, usuarios, cron, logs, tráfico, inbox, backups). Es la misma CLI con cara amable: por debajo ejecuta plak list, plak wp, plak snapshot…
MCP y sitios agent-ready: un sitio con los plugins WP-MCP y HTML Editor, credencial de aplicación y perfil wp-mcp-cli para que un agente descubra y ejecute abilities (discover, describe, run) en lugar de adivinar URLs. Ver MCP.
Panel (cloud.plak.io): tu cuenta con sitios y servidores en producción. plak connect vincula la máquina; plak panel ... lee y opera solo tus recursos propios. El dashboard local y el panel son cosas distintas.

Instalación

Requisitos, instalador y Homebrew, y preparación de la pila local.

Dashboard local

Qué es https://plak.localhost y cómo usar cada sección: ficha, plugins, logs, inbox y backups.

MCP y agentes

Qué es MCP, cómo funciona en Plak y cómo preparar sitios agent-ready.

Temas, editores y plugins

Qué temas, editores e integraciones tienen abilities dedicadas y cuáles van por vía genérica.

Conexión con el panel

Device flow con aprobación en el panel y fallback manual para headless y automatizaciones.

Sitios y servidores del panel

Lista y consulta solo tus recursos propios con paginación y salida JSON.

Sitios locales

Crea, importa, clona y opera sitios WordPress y estáticos en tu máquina.

Remotos y SSH

Aliases SSH, /etc/hosts y claves, con vinculación a sitios locales.

Servicios y red

Pila local, puertos, acceso en red y diagnóstico con status y health.

Vincular y migrar

Vincula un sitio del panel con uno local y usa push/pull revalidados.

Referencia

Sintaxis, opciones y ejemplos de todos los comandos, locales y del panel.

Plugins propios

Los seis plugins de Plak y cómo usarlos con Plak CLI, dashboard y MCP.

Instalación

curl -fsSL https://plak.sh/install | bash
plak install
plak status

Tienes dos formas de instalar el binario —instalador o Homebrew— y después plak install prepara la pila local (FrankenPHP, MariaDB, Mailpit, WP-CLI y wp-mcp-cli). Detalles, requisitos y WSL en Instalación.

Primer sitio

plak add mi-sitio
open https://plak.localhost

plak add crea el WordPress en ~/Plak/Sites/mi-sitio.localhost, lo sirve por HTTPS y, si wp-mcp-cli está instalado, lo deja agent-ready sin que pidas nada (ver MCP). El dashboard muestra el sitio con su ficha, plugins, logs e inbox. Abre https://plak.localhost para verlo.

Mapa de comandos

Área	Comandos
Cuenta del panel	`connect`, `disconnect`, `panel` (lectura, vinculación y operaciones)
Dashboard	`https://plak.localhost` (página local; equivale a `list`, `add`, `wp`, `snapshot`, `login`…)
MCP y agentes	`add --agent`, `agent`, `skill` (perfil y abilities con `wp-mcp`)
Sitios locales	`add`, `import`, `clone`, `delete`, `rename`, `list`, `path`, `url`, `log`
WordPress local	`login`, `wp`, `core`, `network`, `agent`, `db`, `snapshot`, `history`
Migraciones	`pull`, `push`
Servicios locales	`enable`, `disable`, `reload`, `trust`
Configuración local	`ports`, `memory`, `directive`, `mappings`, `proxy`
Acceso en red	`share`, `lan`, `tailscale`, `wsl-hosts`
Remotos SSH	`remote list/add/edit/delete/connect/attach/detach`
Hosts y claves SSH	`hosts list/add/delete`, `sshkey list/view/create/delete`
Estado y mantenimiento	`status`, `health`, `install`, `skill`, `upgrade`, `version`, `help`

Los remotos se agrupan bajo plak remote. La disponibilidad de argumentos y opciones depende de cada comando: consúltala con plak <comando> --help. El detalle de cada sección está en Dashboard, Servicios y red, Vincular y migrar, MCP, Temas, editores y plugins, Sitios locales y Referencia.

Banderas globales

plak --quiet list        # suprime éxitos en STDOUT; los errores siguen en STDERR
plak --json status       # salida JSON donde el comando la soporta
plak <comando> --help    # ayuda del comando, después del nombre

El router procesa --quiet/-q y --json globalmente, pero cada comando implementa su propia salida JSON. Excepción: plak wp <sitio> <args...> pasa todo lo que sigue al nombre del sitio a WP-CLI sin interpretar, incluido --quiet, --json y --help.

plak login genera un enlace de acceso a WordPress; no inicia sesión en la cuenta del panel. La conexión del panel es plak connect.

Archivos y rutas locales

Ubicación	Uso actual
`PLAK_HOME`, por defecto `~/.plak`	Base de la CLI; guarda `connection.json` (URL del panel, token e identidad mínima)
`~/Plak/Sites/<nombre>.localhost`	Directorio de cada sitio local
Archivo `.remote` dentro del sitio	Alias del remoto SSH vinculado
Archivo `.panel-link` dentro del sitio	Vinculación panel ↔ sitio local (panel, cuenta, IDs y remoto; sin secretos)
Archivo `agent-ready` dentro del sitio	Marca de sitio preparado para agentes (WP-MCP + perfil `wp-mcp-cli`)
`PLAK_SSH_CONFIG`, por defecto `~/.ssh/config`	Remotos SSH; la ruta WordPress remota se guarda en el bloque con `# plak-remote-path:`
`~/.ssh`	Claves SSH locales
`PLAK_HOSTS_FILE`, por defecto `/etc/hosts`	Resolución local de dominios
`~/Plak/cache/dashboard-token`	Token CSRF del dashboard (una instalación, un token)
`~/Plak/Logs/errors.log`	Log PHP compartido (el dashboard lo filtra por sitio)

El dashboard local se sirve en https://plak.localhost, con el puerto configurado cuando no es el estándar. Es distinto del panel alojado en cloud.plak.io.

Compatibilidad

Plak CLI contempla macOS y distribuciones Linux, incluyendo detección de WSL. Los comandos interactivos requieren un terminal real porque gum abre prompts TUI; con los valores por banderas no hace falta TTY. Códigos de salida: 0 éxito, 1 uso/configuración, 2 no encontrado, 3 vinculación/integridad.

Consulta Instalación para poner en marcha la máquina, Dashboard para la interfaz web local, MCP para agentes, conexión con el panel para autenticar tu máquina, sitios y servidores del panel para leer tus recursos, sitios locales para el flujo diario sin panel y Plugins para los plugins propios de Plak.