WordPress Studio 1.7.0: conheça o novo Studio CLI

A versão 1.7.0 do WordPress Studio é uma grande atualização para quem está construindo sites WordPress localmente, especialmente desenvolvedores e usuários avançados que gostam de automatizar tarefas e trabalhar a partir do terminal.

Nas versões anteriores, o Studio CLI focava principalmente na criação e gerenciamento de sites de prévia. 

Com a versão dois, ele se torna um companheiro de linha de comando completo para grande parte do seu fluxo de trabalho no Studio, incluindo a criação e gerenciamento de sites locais, execução do WP-CLI no contexto correto, conexão com o WordPress.com e muito mais.

Neste post, vamos revisar o que há de novo e compartilhar maneiras práticas de incorporar o Studio CLI em fluxos de trabalho assistidos por IA. 

Para a referência completa de comandos e opções avançadas, veja a documentação atualizada do Studio CLI (em inglês) incluída com esta versão.

O que é um CLI?

Um CLI (interface de linha de comando) permite que você controle ferramentas e aplicativos digitando comandos em um terminal, em vez de clicar em menus. Os desenvolvedores tendem a gostar de CLIs porque são:

• Rápido: Crie, altere ou remova ambientes com um único comando
• Repetível: Execute os mesmos comandos em qualquer máquina ou incorpore-os em scripts
• Automatizável: Deixe sistemas de construção e agentes de IA executarem comandos por você

Mesmo que você não trabalhe tipicamente no terminal, o Studio CLI ainda vale a pena prestar atenção. 

É a “linguagem” comum que as ferramentas de automação podem usar para interagir com o Studio. Uma vez habilitado, seu editor, scripts ou assistentes de programação de IA podem fazer coisas como criar um novo site, executar atualizações de banco de dados ou publicar uma prévia sem que você precise navegar por várias telas no aplicativo Studio.

Começando com o Studio CLI

Para começar a usar o Studio CLI, complete os seguintes passos:

1. Abra o aplicativo WordPress Studio na sua máquina.
2. No menu principal, abra o modal de Configurações. Você também pode clicar no ícone de engrenagem no canto superior direito do aplicativo.
3. Ative a opção Studio CLI e clique em Salvar.
4. No macOS, você será solicitado a inserir a senha do seu computador para permitir a instalação.

Uma vez que o Studio CLI esteja habilitado, você terá acesso a um comando global studio a partir do seu aplicativo de terminal preferido:

studio <área> <comando> [opções]

No Studio 1.7.0, o CLI agora cobre quatro áreas principais:

• Autenticação: Gerencie sua conta do WordPress.com para funcionalidades que a requerem
• Sites de prévia: Crie e atualize sites de prévia hospedados no WordPress.com
• Gerenciamento de sites locais: Crie, inicie, pare, configure e exclua sites locais gerenciados pelo Studio
• Integração com WP-CLI: Execute comandos WP-CLI dentro de ambientes do Studio configurados corretamente, sem precisar instalar o WP-CLI você mesmo

Você pode ver uma visão geral a qualquer momento executando studio --help:

A maioria dos comandos é projetada para ser executada a partir da pasta raiz de um site gerenciado pelo Studio. 

Para acesso rápido, você pode abrir essa pasta diretamente no seu terminal clicando no botão Terminal na aba Visão Geral do site.

Gerenciando sites locais do Studio

Uma das maiores atualizações no Studio CLI v2 é o gerenciamento de sites locais de ponta a ponta a partir do terminal. 

Em vez de voltar para a interface do usuário do Studio para tarefas rotineiras, você pode criar um site, verificar seu status, iniciá-lo ou pará-lo e limpá-lo quando terminar. 

É um fluxo de trabalho mais rápido no dia a dia, e também torna a automação muito mais fácil, seja você escrevendo scripts ou usando um agente de IA para fazer isso por você.

No centro de tudo isso está o comando studio site. As opções disponíveis incluem:

studio site status    # Obter status do site
studio site create    # Criar um novo site
studio site list      # Listar sites
studio site start     # Iniciar site
studio site stop      # Parar site(s)
studio site delete    # Excluir site
studio site set       # Configurar configurações do site

Crie sites locais com um único comando

Use studio site create para criar um novo site no seu diretório atual ou em um caminho específico. Aqui estão alguns exemplos do que você pode fazer:

# Criar um novo site com opções padrão na pasta atual
studio site create
# Criar um novo site com um domínio personalizado e HTTPS
studio site create --https --domain hello.wp.local
# Criar um site em um diretório diferente
studio site create --path /caminho/para/site

O CLI irá:

• Configurar um ambiente WordPress local.
• Iniciar o servidor WordPress.
• Abrir o WP Admin no seu navegador quando estiver pronto.

Você pode executar isso a partir de uma pasta vazia ou de um diretório que já contém um site WordPress que ainda não está registrado no aplicativo Studio.

Listar, inspecionar, iniciar e parar sites locais

Quando você está trabalhando com vários sites locais, os comandos `list` e `status` tornam o gerenciamento muito mais fácil:

studio site list       # Mostrar todos os sites locais conhecidos pelo Studio
studio site status     # Status do site no diretório atual

A saída do status inclui:

• Se o site está em execução
• A URL local, por exemplo http://localhost:PORT
• Detalhes de configuração importantes, como versão do PHP e informações de login

Iniciar e parar sites também é simples:

studio site start      
studio site stop

Isso funciona bem em scripts que precisam iniciar um site, executar testes ou operações de conteúdo e, em seguida, pará-lo novamente.

Excluir e configurar sites com segurança

Quando você terminar um projeto, pode removê-lo do Studio e, se necessário, excluir todos os arquivos associados do seu computador com os seguintes comandos:

studio site delete          # Remover o site do Studio
studio site delete --files  # Remover o site e arquivos

Para alterações de configuração, studio site set permite que você ajuste as configurações para um site local específico:

studio site set [opções]

Você pode, por exemplo:

• Alterar a versão do PHP ou do WordPress.
• Atualizar o domínio local ou a porta.
• Alternar funcionalidades que afetam como o ambiente local é executado.

Dica: Execute studio site set --help para a lista completa de opções disponíveis.

Autenticação a partir do terminal

Algumas funcionalidades do Studio, como criar ou atualizar sites de prévia, requerem uma conta do WordPress.com logada. 

O Studio CLI v2 oferece comandos dedicados studio auth para que você possa gerenciar isso a partir do terminal:

• studio auth login inicia um fluxo de navegador e fornece um token para você colar de volta no seu terminal para completar o login.
• studio auth status informa se você está autenticado e qual conta está ativa.
• studio auth logout desconecta o CLI da sua conta do WordPress.com e limpa as credenciais armazenadas.

Se você executar um comando que precisa de autenticação enquanto estiver desconectado, como studio preview create que revisaremos a seguir, o CLI irá guiá-lo para fazer login.

Sites de prévia a partir do CLI

Sites de prévia são ambientes temporários e compartilháveis hospedados no WordPress.com que refletem seu site local do Studio. Eles são ideais para compartilhar trabalho com outras pessoas que não têm um ambiente local.

O CLI fornece um conjunto completo de comandos:

studio preview create          # Criar um site de prévia
studio preview list            # Listar todos os seus sites de prévia
studio preview update <host>   # Redeploy alterações para uma prévia
studio preview delete <host>   # Remover um site de prévia

Dica: Execute studio preview list para ver todas as prévias associadas à sua conta do WordPress.com, depois use o valor do host daquela saída com studio preview update ou studio preview delete.

WP-CLI embutido, configurado para você

WP-CLI é a interface de linha de comando oficial para o WordPress. O Studio CLI v2 o integra diretamente através de um comando dedicado studio wp, para que você não precise instalar ou configurar o WP-CLI por conta própria:

studio wp [<wp-cli-command>] [<wp-cli-arguments>...]

A partir do diretório raiz do seu site, você pode executar tarefas comuns do WP-CLI como:

• studio wp core version mostra a versão do WordPress para o site atual.
• studio wp plugin list lista os plugins instalados (e seu status).
• studio wp core update-db executa quaisquer atualizações de banco de dados necessárias após uma atualização do WordPress.

O Studio define as variáveis de ambiente, caminhos e credenciais para você, para que esses comandos sejam executados no banco de dados e arquivos corretos sem configuração extra.

Usando o Studio CLI com ferramentas de codificação de IA

Uma das maiores vantagens do Studio CLI v2 é como ele se encaixa naturalmente em fluxos de trabalho de desenvolvimento assistidos por IA, especialmente com ferramentas como Claude Code e Cursor. 

Esses agentes leem o código no seu projeto local (incluindo temas e plugins) e executam comandos no seu ambiente, o que torna possível descarregar muito do trabalho repetitivo. Por exemplo, eles podem:

• Usar comandos studio site para criar, iniciar, parar e gerenciar ambientes locais.
• Executar studio wp para diagnósticos, tarefas de banco de dados e gerenciamento de conteúdo.
• Criar e atualizar sites de prévia do WordPress.com para revisão sem sair do seu editor.

Fornecer contexto

A ferramenta de IA que você está usando pode não entender automaticamente o WordPress Studio ou o Studio CLI. Para obter resultados úteis, comece dando ao agente de IA um pouco de contexto sobre o que está analisando e quais ferramentas pode usar.

Por exemplo, imagine que você abriu uma pasta de site local do Studio no seu terminal. 

Comece dizendo ao agente de IA o que é esse diretório e que ele pode executar o Studio CLI. 

Neste exemplo, usaremos o Claude Code e notaremos explicitamente que ele pode invocar o CLI via studio.

“Esta é a pasta de um site do WordPress Studio. Você tem acesso ao Studio CLI, que pode ser invocado executando studio. Comece explorando as opções disponíveis.”

A partir daí, você deve receber uma resposta que se pareça com isso:

Com um simples prompt, a IA agora tem uma compreensão sólida do Studio CLI. Este exemplo foi gerado usando o Opus 4.5.

Automatizar a configuração do ambiente

Uma vez que a IA entende o que o Studio pode fazer, você pode começar a delegar tarefas de configuração rotineiras. Por exemplo, você pode dizer ao seu agente:

“Configure um novo site WordPress local usando o Studio com o nome “Site do Nick””

Nos bastidores, ele pode executar algo como:

studio site create --path "../site-do-nick" --name "Site do Nick" --skip-browser

Aqui está um exemplo da saída do Claude Code, novamente usando o Opus 4.5.

Depuração e verificação com WP-CLI

O Studio também facilita a solução de problemas usando o WP-CLI — especialmente quando você está encarando um erro e não quer caçar manualmente a causa.

Você pode dizer:

“Use o Studio CLI para executar verificações do WP-CLI e descobrir por que este site está falhando, depois proponha correções.”

A partir daí, o agente pode:

• Executar comandos studio wp (por exemplo, plugin list, theme list ou core update-db) para coletar diagnósticos.
• Sugerir (ou aplicar) alterações de código e configuração com base no que encontra.
• Reexecutar as mesmas verificações do WP-CLI para confirmar que o problema foi resolvido.

Se você ainda não conferiu, veja esta ótima visão geral do WP-CLI para ter uma noção do que ele pode fazer.

Criando sites de prévia

Sites de prévia são uma das funcionalidades mais populares no WordPress Studio, mas criá-los e mantê-los atualizados pode parecer um pouco tedioso se você estiver fazendo isso através da interface do usuário do Studio. 

O CLI agiliza o fluxo de trabalho, e se torna ainda mais fácil quando você o combina com um agente de IA.

Quando você estiver pronto para compartilhar seu trabalho com um cliente ou colega, pode simplesmente pedir ao seu IA para criar um site de prévia:

“Você pode criar um site de prévia para mim?”

Se você ainda não estiver autenticado, o agente irá solicitar que você faça login, depois criará a prévia e retornará a URL. A saída deve se parecer com algo assim:

À medida que você continua trabalhando localmente, pode periodicamente pedir ao agente para atualizar o site de prévia. 

Se você também estiver usando a IA para ajudar a construir o site, tema ou plugin, pode até adicionar uma regra como: após qualquer alteração significativa, atualize o site de prévia automaticamente para que seu link compartilhado permaneça atual.

Melhores práticas ao usar IA com o Studio CLI

Agentes de IA podem ser copilotos incrivelmente eficazes quando você os combina com o Studio CLI. Eles podem acelerar a configuração, solução de problemas, implantações de prévia e executar comandos reais no seu ambiente. 

Dito isso, um pouco de estrutura no início ajuda você a obter os benefícios enquanto evita surpresas desagradáveis.

• Trabalhe a partir da raiz do site do Studio (ou use `–path`). Isso garante que os comandos sejam executados no projeto que você realmente pretende, especialmente se você tiver vários sites na sua máquina.
• Defina limites claros em seus prompts. Por exemplo: “Não exclua sites”, “Execute apenas comandos de leitura do studio wp” ou “Pergunte antes de executar migrações de banco de dados.”
• Verifique operações destrutivas. Para comandos como studio site delete e studio preview delete, faça com que o agente mostre os comandos exatos que planeja executar antes de executar qualquer coisa.

Usado de forma consciente, IA mais Studio CLI pode remover grande parte da configuração repetitiva, testes e fricção de implantação, para que você possa se concentrar mais em projetar e construir ótimas experiências WordPress.

Comece a construir com o Studio CLI

O Studio CLI v2 torna o WordPress Studio mais scriptável e amigável à automação para o desenvolvimento diário, seja você executando comandos por conta própria ou trabalhando com um agente de IA.

Se você quiser ir mais longe, a documentação do Studio CLI passa por tudo o que você pode fazer e como encaixá-lo no seu fluxo de trabalho.

Se você ainda não experimentou o WordPress Studio, ou se já faz um tempo, este é um ótimo momento para começar. Baixe o Studio, crie um site e teste rapidamente o CLI atualizado.