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.

Se você ainda está escolhendo entre navegador, CLI, Blueprints e integrações com IA, comece pelo guia completo de WordPress Playground.

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)

Não gosta de terminal? Tem a extensão do VS Code

A CLI é poderosa, mas se o seu fluxo é todo dentro do editor, existe a extensão oficial do VS Code. Ela embarca o PHP em WebAssembly e o SQLite — você instala, clica em Start WordPress Server e tem um WordPress rodando, sem tocar no terminal. Mesma tecnologia da CLI, outra porta de entrada.

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)

Indo além: a CLI dentro do seu código

A CLI não serve só para o terminal. A função runCLI permite controlar o Playground programaticamente a partir de JavaScript ou TypeScript — útil para automação, testes end-to-end e pipelines de CI/CD. Em vez de chamar o comando e ler a saída, você orquestra a instância direto no seu script. É a ponte natural entre a CLI e os testes E2E.

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.