wp-env

Automate Docker-based WordPress local environments with wp-env.

Updated Feb 12, 2026
One-click install
npx skills add https://github.com/obenland/dotfiles --skill wp-env-obenland
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: wp-env
Source: https://github.com/obenland/dotfiles/tree/main/claude/.claude/skills/wp-env
Command: npx skills add https://github.com/obenland/dotfiles --skill wp-env-obenland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

WordPress development environments can be slow to configure and inconsistent across machines; this skill automates their creation and management using the wp-env tool.

Core Features & Use Cases

  • Zero-config startup and management for WordPress environments using wp-env.
  • Manage development and testing containers, ports, and common workflows (WP-CLI, migrations, tests).
  • Real-world use: bootstrap a plugin development workflow by mounting the plugin directory, starting the environment, and running commands inside the containers.

Quick Start

Start by running wp-env start from your project root to bootstrap the local WordPress environment.

Frequently Asked Questions about wp-env

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate local WordPress environment creation with Docker?▼

You can automate local WordPress environment creation by using the wp-env tool to instantly bootstrap Docker-based containers. This provides a zero-config, reproducible setup for consistent development and testing workflows across different machines.

What do I need to run wp-env for WordPress plugin development?▼

To run wp-env for WordPress plugin development, you need Docker, Node/npm, and the wp-env tool installed. This stack allows you to mount your plugin directory and manage development and testing containers directly from your project root.

Can I configure environment variables and ports for my local WordPress setup?▼

Yes, you can configure environment variables and manage ports for your local WordPress setup using a .wp-env.json configuration file. This ensures reproducible environments and allows you to customize common workflows like WP-CLI executions and database migrations.

What is the best way to manage development and testing containers for WordPress themes?▼

The best way to manage development and testing containers for WordPress themes is using wp-env to orchestrate Docker environments. It handles starting, stopping, and updating containers, enabling efficient validation and testing within isolated local instances.

Why does my wp-env startup fail when bootstrapping a local environment?▼

Your wp-env startup might fail because Docker or Node/npm dependencies are not properly installed or running. Ensure Docker is active and npm packages are correctly configured before attempting to bootstrap your local WordPress environment.