CLI Commands
All WOW! commands are invoked via WP-CLI from your WordPress root directory.
wp package install alo-labs/wow # Install WOW!
/wow # Run full optimization pipeline
/wow --dry-run # Audit only — no changes made
/wow --domain=example.com # Target a specific domain
/wow rollback # Revert to last backup
/wow --report # Display last run report
/wow --version # Show installed WOW! version
/wow --skip-plugin # Run pipeline skipping Plugin agent
/wow --skip-provider # Run pipeline skipping Provider agent
/wow --skip-custom # Run pipeline skipping Custom agent
/wow --skip-backup # Run pipeline skipping Backup agent (not recommended)Global Flags
| Flag / Subcommand | Description |
|---|---|
--dry-run | Audit and plan only; make no changes |
--domain=<url> | Override the target domain for Lighthouse scans |
rollback | List restore points and revert to selected snapshot |
--report | Print the last run's HTML/JSON report path |
--version | Print installed WOW! version |
--skip-<agent> | Skip a named agent (e.g., --skip-plugin, --skip-provider) |
--config=<path> | Path to an alternate wow.config.json |
Agent Reference
Each agent can be skipped individually using --skip-<agent-name>.
| Agent | Agent File(s) | What it does | Skip flag |
|---|---|---|---|
| Orchestrator | (CLAUDE.md orchestration loop) | Pipeline sequencing only — cannot be skipped | — |
| Audit | lighthouse-agent + inventory-agent | Lighthouse scan, Core Web Vitals baseline, full plugin/theme/asset inventory | --skip-audit |
| Screenshot | screenshot-agent | Captures before/after screenshots for regression comparison | --skip-screenshot |
| Theme Analysis | theme-analysis-agent | Detects theme-level performance and compatibility issues | --skip-theme |
| Planner | plan-agent | Generates the prioritized change plan from audit findings | --skip-plan |
| Backup | backup-agent | Full DB + files snapshot to /tmp/.wow/backups/ before any changes |
--skip-backup (not recommended) |
| Plugin | plugin-agent | Audits and optimizes plugin configuration and load order | --skip-plugin |
| Provider | provider-agent | Applies server-side and hosting-tier optimizations | --skip-provider |
| Hostinger | hostinger-agent | Hostinger-specific hPanel tuning — invoked by provider-agent on Hostinger environments | --skip-hostinger |
| Custom | custom-agent | Applies custom code-level optimizations (theme/content via mu-plugin) | --skip-custom |
| Visual Regression | visual-regression-agent | Compares before/after screenshots; flags regressions for review | --skip-visual-regression (not recommended) |
| Report | report-agent | Generates the final styled HTML + markdown performance report | --skip-report |
Configuration
WOW! looks for wow.config.json in the WordPress root directory. All fields are optional — WOW! uses sensible defaults when the file is absent.
{
"domains": ["example.com"],
"agents": {
"plugin": {
"skip_deactivate": []
},
"provider": {
"hostinger_autopilot": true
},
"backup": {
"offload": false,
"offload_path": "/mnt/backups"
}
},
"report": {
"format": "html",
"output_dir": "wp-content/wow-reports"
}
}Note: The domains key controls which URLs are targeted during Lighthouse scans. It does not control WOW!'s internal execution agents.
Configuration Fields
| Field | Type | Default | Description |
|---|---|---|---|
domains | string[] | auto-detected | Target URLs for Lighthouse scans (not execution domains) |
agents.backup.offload | boolean | false | Copy backup to remote path after creation |
agents.backup.offload_path | string | — | Remote path for backup offload |
agents.provider.hostinger_autopilot | boolean | true | Auto-invoke hostinger-agent when Hostinger environment detected |
report.format | string | "html" | Report output format: html or json |
WP-CLI Integration
WOW! is distributed as a WP-CLI package and integrates with the standard WP-CLI package manager.
- Requires WP-CLI 2.5 or later — wp-cli.org
- Installed globally via
wp package install— available for all sites managed by WP-CLI on the server - Update with
wp package update alo-labs/wow - Remove with
wp package uninstall alo-labs/wow - Compatible with any WP-CLI setup (local, remote SSH, Trellis, Bedrock, etc.)
WOW! does not modify WordPress core files. All changes are reversible via /wow rollback.