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.