npx claudepluginhub codigodoleo/superpowers-sage --plugin superpowers-sageThis skill uses the workspace's default tool permissions.
- Performing database operations (export, import, optimize, search-replace)
Guides WP-CLI operations for WordPress: safe search-replace, DB export/import, plugin/theme/user/content management, cron events, cache flushing, multisite handling, and wp-cli.yml scripting.
Sets up and verifies WordPress site access via WP-CLI over SSH or REST API, configures authentication, checks content/plugins, and saves connection configs.
Manages Roots Sage WordPress themes with Acorn and Lando: environment setup, ACF blocks/fields, Blade components/composers, Tailwind v4/Vite frontend, service providers, CPTs, and generators.
Share bugs, ideas, or general feedback.
All WP-CLI commands must be prefixed with lando wp to execute inside the Lando container.
See references/db-operations.md for export, import, and search-replace workflows.
Quick reference:
# Export backup
lando wp db export "backup-$(date +%Y%m%d-%H%M%S).sql"
# Search-replace (always dry-run first)
lando wp search-replace 'https://old.com' 'https://new.com' --dry-run --precise --all-tables
lando wp search-replace 'https://old.com' 'https://new.com' --precise --all-tables
Scripts: scripts/db-backup.sh and scripts/search-replace.sh.
See references/content-ops.md for user management, post operations, and option manipulation.
Quick reference:
lando wp user create <username> <email> --role=<role> --user_pass=<password>
lando wp post list --post_type=<type> --fields=ID,post_title
lando wp option update my_option '{"key":"value"}' --format=json
See references/maintenance-deploy.md for the full deploy sequence.
Quick reference:
lando wp maintenance-mode activate
lando wp cache flush
lando wp transient delete --all
lando wp rewrite flush
lando wp maintenance-mode deactivate
See references/preflight-checks.md for mandatory checks before any destructive WP-CLI command.
Key rules:
lando wp db export--format=json when updating serialized optionslando wp acorn <command-name>
lando wp acorn list
Cross-reference the acorn-commands skill for creating and running custom Acorn artisan commands within Lando.
lando wp plugin list or lando wp theme list| Symptom | Likely cause | Fix |
|---|---|---|
lando wp command not found | Lando not running or misconfigured | Run lando start, check .lando.yml tooling |
| Search-replace corrupts serialized data | Missing --precise flag | Restore from backup, re-run with --precise |
| Database import fails | SQL file too large or charset mismatch | Split the file, check max_allowed_packet, verify charset |
| Plugin activation fatal error | PHP compatibility or dependency conflict | Check PHP version, review error log with lando logs |
| Cron events not firing | DISABLE_WP_CRON set without system cron | Add system cron or remove the constant in dev |
| Maintenance mode stuck | .maintenance file not removed | lando wp maintenance-mode deactivate or manually remove the file |
wp acorn commands fail | Acorn not bootstrapped | Verify Acorn is installed and activated, check app/Providers/ |
lando info and lando logs