wp-create

WP Create — Environment Setup Orchestrator

Create a full local WordPress development environment: detect available tools, download WordPress, create the database, configure the web server, install plugins, and generate the .wp-create.json manifest. Supports native (Nginx/Apache/Caddy), Docker, DDEV, Lando, and wp-env environments.

$WP convention: Throughout this command, $WP refers to the WP-CLI wrapper determined by the chosen environment. For native installs it is wp --path=<path>, for Docker it is docker exec <container> wp --allow-root, for DDEV it is ddev wp, for Lando it is lando wp, for wp-env it is npx wp-env run cli wp. Substitute the correct wrapper in every WP-CLI command below.

---

Step 0: Parse Arguments

Extract the --path= value from $ARGUMENTS.

• If $ARGUMENTS contains --path=<value>, use <value> as the target project path.
• If $ARGUMENTS is a bare path (no flag), treat it as the target path.
• If no path is provided, ask the user:

  "Where should the WordPress project be created? Provide an absolute path (e.g., /var/www/html/my-project):"

• Resolve the path to an absolute path.
• Store it as PROJECT_PATH for use in all subsequent steps.

---

Step 1: Environment Detection

Run the detection script to discover what tools are available on the system.

bash -c "${CLAUDE_PLUGIN_ROOT}/bin/wp-env-setup.sh detect"

Parse the JSON output. The structure is:

{
  "os": "fedora",
  "package_manager": "dnf",
  "web_servers": {
    "nginx": { "installed": true, "version": "1.24.0", "running": true },
    "apache": { "installed": true, "version": "2.4.58", "running": false },
    "caddy": { "installed": false }
  },
  "php": {
    "versions": ["8.2", "8.3"],
    "active": "8.3",
    "extensions": ["mysql", "curl", "mbstring", "xml", "gd", "zip", "intl"]
  },
  "docker": {
    "installed": true,
    "version": "24.0.7",
    "compose": true
  },
  "tools": {
    "ddev": { "installed": false },
    "lando": { "installed": false },
    "wp-env": { "installed": false },
    "wp-cli": { "installed": true, "version": "2.9.0" }
  },
  "database": {
    "mariadb": { "installed": true, "version": "10.11", "running": true },
    "mysql": { "installed": false }
  }
}