create-oxygen-wp

Scaffold a local WordPress + AI-agent development environment (Docker Compose) with Oxygen pre-installed and activated — WordPress + MariaDB plus an isolated workspace container with Node, Claude Code, PHP, and WP-CLI ready to go.

One command scaffolds the project and runs the initial setup for you — docker compose up, then installs WordPress, Oxygen, and the agent tooling — so you land on a working site.

Usage

# npm create form:
npm create oxygen-wp my-site

# or directly with npx:
npx create-oxygen-wp my-site

# choose a host port (default 8080):
npx create-oxygen-wp my-site --port=8090

# just write files, don't touch Docker:
npx create-oxygen-wp my-site --scaffold-only

Docker must be running. When it finishes you have a live site at http://localhost:8080 with Oxygen installed — log in at /wp-admin with admin / password. Then:

cd my-site
npm run start      # bring the stack up next time (it stays up otherwise)
npm run bash       # shell into the workspace container
npm run claude     # launch Claude Code in the workspace

What you get

The full sandbox from create-wp-local-dev-agent-sandbox — WordPress + Claude Code + the WordPress & Playwright MCP servers + Root for Agents — plus Oxygen, installed and activated on the first npm run setup.

Requirements

• Node.js >= 18 (to run the CLI and the project's npm scripts)
• Docker with Compose v2 (to actually run the environment)

License

GPL-2.0-or-later