O WordPress sempre contou com diversas ferramentas de desenvolvimento local, a sua maioria necessitando da instalação de softwares extras ou do uso de Docker.

O WordPress Playground CLI chegou para mudar esse jogo, executando um ambiente completo no seu terminal de forma rápida e, agora, com persistência de dados.

Como funciona o WordPress Playground CLI?

O WordPress Playground CLI é um pacote Node.js (@wp-playground/cli) que roda uma instância de WordPress com WebAssembly (WASM) localmente. Se você já usou a versão web, sabe da velocidade; no terminal, essa agilidade é combinada com o poder de automação.

Para começar, você precisa do Node.js (v20.18+) instalado. Uma vez pronto, você tem duas formas principais de iniciar seu ambiente:

1. O Novo Comando start (Recomendado)

Lançado recentemente (fevereiro de 2026), o comando start simplifica drasticamente o fluxo de trabalho. Sua maior vantagem é a persistência:

npx @wp-playground/cli startCode language: CSS (css)

Diferente do comando antigo, o start salva o estado do seu site (banco de dados e arquivos) na pasta ~/.wordpress-playground/sites/. Isso significa que se você fechar o terminal e abrir no dia seguinte, seu conteúdo continuará lá.

• Dica: Se quiser limpar tudo e começar do zero, use a flag --reset.

2. O Comando server (Efêmero)

Se você precisa apenas de um ambiente temporário para um teste rápido que pode ser descartado ao fechar o terminal, o comando server ainda é a escolha ideal:

npx @wp-playground/cli serverCode language: CSS (css)

Testando seus temas e plugins com --auto-mount

Um dos maiores benefícios de usar a CLI em vez do navegador é a integração com seu código local. Use a flag --auto-mount dentro da pasta do seu plugin ou tema:

cd meu-plugin-incrivel
npx @wp-playground/cli server --auto-mountCode language: CSS (css)

O Playground irá detectar automaticamente se você está em um tema ou plugin e “montar” esse diretório dentro da instalação virtual do WordPress. Qualquer alteração no seu VS Code será refletida instantaneamente no site.

Escolhendo Versão do WordPress e PHP

Precisa validar a compatibilidade com o futuro PHP 8.4 ou com a versão estável mais recente do WordPress? É simples:

npx @wp-playground/cli start --wp=latest --php=8.4Code language: CSS (css)

Gerenciamento de Banco de Dados com phpMyAdmin

Uma das novidades mais pedidas era uma forma fácil de visualizar o banco de dados. Como o Playground utiliza SQLite por baixo dos panos, nem todas as ferramentas de interface eram compatíveis. Agora, você pode lançar o phpMyAdmin diretamente em seu ambiente:

npx @wp-playground/cli start --phpmyadminCode language: CSS (css)

Isso disponibiliza uma interface completa para executar queries SQL e inspecionar tabelas, utilizando um driver que traduz comandos MySQL para SQLite em tempo real.

Automação Avançada com Blueprints

Para elevar o nível, você pode usar Blueprints — arquivos JSON que definem o estado inicial do seu site (plugins instalados, configurações de rede, conteúdo base).

{
  "landingPage": "/wp-admin/",
  "steps": [
    {
      "step": "installPlugin",
      "pluginData": {
        "resource": "wordpress.org/plugins",
        "slug": "akismet"
      }
    },
    { "step": "login" }
  ]
}Code language: JSON / JSON with Comments (json)

Para executar:

npx @wp-playground/cli start --blueprint=setup.jsonCode language: CSS (css)

Conclusão: Por que usar a CLI?

A CLI do WordPress Playground transforma o desenvolvimento de um “fazer manual” em um “pipeline automatizado”. Com o novo comando start, a barreira entre um ambiente local tradicional e o Playground desapareceu, mantendo apenas a vantagem da velocidade.

Se você trabalha com IA (como Gemini CLI ou Claude Code), esses comandos são fundamentais para criar Hooks que iniciam seu ambiente de teste automaticamente a cada sessão de codificação.