Referencia local

Sintaxis, opciones y ejemplos de todos los comandos locales de Plak CLI.

Todos los comandos que funcionan sin cuenta del panel (los de cuenta están en Referencia del panel). Comprobado con plak v0.4.66: cada uso coincide con plak <comando> --help.

Banderas globales

Excepción: plak wp <sitio> <args...> pasa todo lo que sigue al sitio a WP-CLI sin interpretar, incluidos --quiet, --json y --help. Códigos de salida: 0 éxito, 1 uso/configuración, 2 no encontrado, 3 vinculación/integridad.

Sitios

plak add

plak add <nombre> [--wp-version latest|nightly|<versión>] [--multisite subdomains|subdirectories] [--plain] [--agent|--no-agent] [--no-reload]

No interactivo, sin --yes. Falla si el sitio o la base de datos ya existen; limpia solo lo creado por ese intento. WordPress nuevo usa WP_ENVIRONMENT_TYPE=local con debug activado.

plak add mi-sitio
plak add estático --plain --no-reload
plak add red --multisite subdomains

plak import

plak import <nombre> <backup.zip> [--plain] [--yes] [--no-reload]

Crea un sitio desde un ZIP, tar.gz, tgz o tar con un árbol WordPress de un solo sitio y un SQL reconocible (incluye exportaciones de Plak, Local y hostings). Rechaza rutas fuera del destino, SQL ambiguo o ausente, y multisitio. Un fallo deja el sitio parcial e indica cómo eliminarlo.

plak import mi-sitio ./backup.zip
plak import mi-sitio ./backup.tar.gz --yes --no-reload

plak clone

plak clone <origen> <destino> [--yes] [--no-reload]

Duplica archivos y base de datos con URLs reescritas al destino. Empieza con logs vacíos y sin dominios exclusivos ni vinculaciones remotas, así que nunca despliega al remoto del origen. Solo pregunta con TTY y gum si falta --yes.

plak clone origen destino --yes

plak delete

plak delete <nombre> [--force|--yes] [--no-reload]

Borra directorio, base de datos, directiva Caddy y entradas de /etc/hosts (con sudo). Sin TTY no pregunta (auto-fuerza); con TTY pide confirmación salvo --force/--yes.

plak delete mi-sitio
plak delete mi-sitio --force --no-reload

plak rename

plak rename <anterior> <nuevo>

Sin ayuda propia ni flags. Mueve el directorio y la base de datos con search-replace de URLs. En multisitio delega al flujo de red. Regenera el servidor siempre.

plak rename viejo nuevo

plak list

plak list [--totals] [--json]

Tabla (nombre, dominio, tipo, tamaño) o JSON (name, domain, type, size, agent_ready, multisite_mode, network). --totals calcula tamaños.

plak list
plak list --totals --json

plak path · plak url

plak path <nombre>
plak url <sitio>

Imprimen la ruta public/ y la URL HTTPS (con puerto si no es 443). Salida plana, apta para $(...). Sin ayuda propia (path), url sí tiene la suya.

plak log

plak log [sitio] [-f|--follow]

Sin sitio muestra ~/Plak/Logs/errors.log; con sitio, sus caddy.log y caddy-lan.log. -f sigue en directo.

plak log
plak log mi-sitio --follow

WordPress

plak login

plak login <sitio> [<usuario>] [--subsite <id>] [--raw]

Genera un enlace único de WordPress (token de 7 hex, 900 s, un solo uso; no es login del panel). <usuario> puede ser ID, email o login (cualquier rol si es explícito; si se omite usa el primer administrador). --raw imprime solo la URL.

plak login mi-sitio
plak login mi-sitio admin --raw

plak wp

plak wp <sitio> <argumentos wp-cli...>

Todo lo que sigue al sitio pasa intacto a WP-CLI con el mismo PHP que la web (resuelve el PHAR entre symlinks y wrappers). Sin TTY requerido; hereda stdin/stdout/stderr y el exit code.

plak wp mi-sitio plugin list --format=json
plak wp mi-sitio option get siteurl

plak core

plak core [list|<sitio>] [--check]
plak core update <sitio>|--all [--version latest|nightly|<versión>] [--allow-downgrade]

Inspecciona (list funciona sin red) o actualiza el core conservando wp-content y wp-config.php. --check consulta WordPress.org (10 s de timeout). Los downgrades y transiciones nightly exigen --allow-downgrade; haz snapshot antes: nada restaura la BD solo.

plak core list
plak core mi-sitio --check
plak core update mi-sitio --version 6.8.2
plak core update --all --version 6.8.2

plak network

plak network <sitio> [--json]
plak network create <sitio> <slug> [--title <título>]

Inspecciona la red multisitio o crea subsitios (normaliza su URL a https). Solo red raíz local bajo <sitio>.localhost.

plak network mi-red --json
plak network create mi-red equipo --title 'Equipo'

plak agent

plak agent <sitio> [--json]

Prepara o repara un WordPress para agentes: instala WP-MCP y HTML Editor, fija permalinks y dominio de habilidades, rota la Application Password Plak CLI (agent) del usuario admin, registra el perfil wp-mcp-cli y verifica habilidades. Idempotente.

plak agent mi-sitio
plak agent mi-sitio --json

Base de datos, snapshots e historial

plak db

plak db backup
plak db list [--json]
plak db port [set <puerto>] [--yes] [--dry-run]

backup vuelca cada WordPress a private/database-backup-*.sql. list muestra credenciales y tamaños. port consulta o cambia el puerto de MariaDB (con rollback si la verificación falla).

plak db backup
plak db list --json
plak db port set 3307 --dry-run

plak snapshot

plak snapshot <sitio> create [--note <texto>] [--json]
plak snapshot <sitio> list [--json]
plak snapshot <sitio> restore <id> [--yes]
plak snapshot <sitio> delete <id> [--yes]
plak snapshot <sitio> export <id> [--output <ruta>]

Puntos locales de archivos + base de datos (private/snapshots/<id>; los estáticos solo archivos). Restaurar guarda antes una snapshot de seguridad. restore/delete exigen --yes sin TTY.

plak snapshot mi-sitio create --note antes-cambio
plak snapshot mi-sitio restore 20260101T120000Z-a1b2c3 --yes

plak history

plak history <sitio> save [--note <texto>] [--background]
plak history <sitio> list
plak history <sitio> show <id> [<ruta>]
plak history <sitio> diff <desde> <hasta|current> [<ruta>]
plak history <sitio> restore <id> <ruta> --yes [--background]
plak history <sitio> recover --yes
plak history <sitio> jobs
plak history <sitio> schedule hourly|daily --enable
plak history <sitio> schedule --disable

Versiona wp-content (plugins/<slug>, themes/<slug>, mu-plugins/...): solo ficheros, sin BD ni activaciones. Salida siempre JSON. restore/recover exigen --yes incluso con TTY.

plak history mi-sitio save --note antes-actualizar
plak history mi-sitio restore <id> plugins/mi-plugin --yes

Migraciones

plak pull · plak push

plak pull [<sitio>] [--yes] [--proxy-uploads]
plak push [<sitio>] [--yes]

Envían el motor Plak al remoto por SSH: no necesita internet ni URL pública, y el backup viaja por SSH. Antes de tocar la BD comprueban herramientas y cancelan con mensaje útil si falta alguna. --proxy-uploads (solo pull) excluye uploads del backup y sirve los remotos por proxy. Con sitio vinculado al panel, el destino se revalida primero (ver Vincular y migrar). Rechazan multisitio.

plak pull mi-sitio --yes
plak pull mi-sitio --yes --proxy-uploads
plak push mi-sitio --yes

Remotos, hosts y claves

plak remote

plak remote list [--managed] [--unmanaged] [--json]
plak remote add <nombre> --host <host> --user <usuario> [--port <puerto>] [--path <ruta>] [--identity <fichero>|--no-identity]
plak remote edit <nombre> [--newname N] [--host H] [--user U] [--port P] [--path RUTA] [--identity F|--no-identity]
plak remote delete <nombre> [--yes]
plak remote connect [nombre]
plak remote attach <remoto> <sitio> [--yes]
plak remote detach <sitio> [--yes]

add registra el host en ~/.ssh/config y la ruta WordPress como # plak-remote-path: en el mismo bloque. Con attach, push/pull omiten sus preguntas. connect abre SSH en la ruta configurada. Todo admite banderas no interactivas (plak remote help tiene el detalle).

plak hosts

plak hosts list
plak hosts add <ip> <dominio>
plak hosts delete <dominio> [--yes]

Crea copia de seguridad junto al archivo antes de escribir. En /etc/hosts suele requerir sudo.

plak sshkey

plak sshkey list
plak sshkey view [clave-o-ruta]
plak sshkey create [nombre] [--yes]
plak sshkey delete [nombre] [--yes]

Sin nombre pregunta con gum; sin TTY, delete exige --yes.

Servicios y configuración

Acceso en red

Estado y mantenimiento