What is WOW?
WOW! is an AI-native autonomous agentic performance optimizer for WordPress. It is not a plugin — it is a WP-CLI package that runs a coordinated pipeline of specialist AI agents, each responsible for a specific optimization domain.
You trigger the entire pipeline with a single command:
/wowFrom that point, WOW! audits your site, plans changes, takes a full backup, executes optimizations, verifies results with visual regression testing, and delivers a detailed report — all without further input.
First-Run Setup
On first run, WOW! walks you through a short setup before starting the pipeline:
- Site URL — the target WordPress site (e.g.,
https://yourdomain.com) - WordPress admin credentials — username and password for the WP admin account
- SSH access (optional) — enables server-side optimizations such as provider-level tuning
These are stored locally in your WP-CLI config and are never transmitted or written to disk in plaintext. Subsequent runs reuse the saved credentials automatically.
The 5 Optimization Focus Areas
WOW! organizes optimization work into five user-facing focus areas. Each focus area maps to one or more specialist agents in the internal execution model (Plugin, Provider, Custom, Theme, Content). These focus areas reflect what gets improved — the agents handle how.
| Focus Area | Focus | Key Metrics |
|---|---|---|
| Performance | Core Web Vitals, page speed | LCP, CLS, INP, TTFB |
| Security | SSL configuration, HTTP headers, hardening | SSL grade, header score |
| SEO | Meta tags, structured data, sitemaps | Crawlability, schema coverage |
| Caching | Server, browser, and CDN cache rules | Cache hit rate, TTFB |
| Image Optimization | Compression, modern formats, lazy-load | Image byte savings, LCP |
The 12 Specialist Agents
WOW! deploys 12 agents. Each agent is scoped to a single responsibility, making the system auditable and safe to extend.
| Friendly Name | Actual Agent File(s) | Responsibility |
|---|---|---|
| Orchestrator | (CLAUDE.md orchestration loop) | Sequences all agents; reruns the full pipeline until improvement falls below 5% |
| Audit | lighthouse-agent + inventory-agent | Baseline performance scan + full plugin/theme/asset inventory |
| Screenshot / Visual State | screenshot-agent | Captures before/after screenshots for regression comparison |
| Theme Analysis | theme-analysis-agent | Detects theme-level performance and compatibility issues |
| Planner | plan-agent | Generates the prioritized change plan from audit findings |
| Backup | backup-agent | Full DB + files snapshot before any changes |
| Plugin | plugin-agent | Audits and optimizes plugin configuration and load order |
| Provider (incl. Hostinger) | provider-agent + hostinger-agent | Applies server-side and hosting-tier optimizations; Hostinger-specific tuning via hostinger-agent |
| Custom | custom-agent | Applies custom code-level optimizations |
| Visual Regression | visual-regression-agent | Compares before/after screenshots; flags regressions for review |
| Report | report-agent | Generates the final HTML performance report |
Note: hostinger-agent is a specialized sub-agent of the Provider tier, invoked automatically when a Hostinger environment is detected.
Any agent can be skipped individually with --skip-<agent> (e.g., /wow --skip-plugin).
Iteration Loop
WOW! does not run the pipeline just once. After each full cycle (Audit → Plan → Execute → Verify → Report), it measures the performance improvement achieved. If the improvement is 5% or greater, WOW! automatically begins a new cycle — re-auditing the site and generating a fresh plan based on the updated state. This loop continues until the measured improvement between cycles falls below 5%, or until no further actionable findings remain.
This compounding approach ensures that second- and third-order gains are captured without over-optimizing.
Backup & Rollback
WOW! is designed to be safe by default. The Backup agent runs before any change is made and creates a full snapshot of your site:
- Complete database export
- Full
wp-content/file archive - Snapshot stored in
/tmp/.wow/backups/
If the Visual Regression agent detects a regression after execution, it flags the run and records the regression in the report. You can then restore the pre-run backup manually with /wow rollback.
You can also trigger a manual rollback at any time:
/wow rollbackWOW! lists available restore points and prompts for confirmation before restoring.