WordPress Studio 1.7.0: Meet the New Studio CLI

Model 1.7.0 of WordPress Studio is a big improve for someone development WordPress websites in the community, particularly builders and gear customers who love to automate duties and paintings from the terminal.

In previous releases, the Studio CLI centered principally on developing and managing preview websites. 

With model two, it turns into a full-featured command-line significant other for a lot of your Studio workflow, together with developing and managing native websites, operating WP-CLI in the proper context, connecting to WordPress.com, and extra.

On this put up, we’ll overview what’s new and percentage sensible techniques to include the Studio CLI into AI-assisted workflows. 

For the whole command reference and complex choices, see the up to date Studio CLI documentation incorporated with this liberate.

What’s a CLI?

A CLI (command-line interface) allows you to keep an eye on gear and programs by means of typing instructions right into a terminal, as an alternative of clicking via menus. Builders have a tendency to love CLIs as a result of they’re:

• Speedy: Spin up, exchange, or take away environments with a unmarried command
• Repeatable: Run the similar instructions on any device, or bake them into scripts
• Automatable: Let construct techniques and AI brokers run instructions for you

Despite the fact that you don’t usually paintings within the terminal, the Studio CLI remains to be price taking note of. 

It’s the typical “language” automation gear can use to have interaction with Studio. As soon as it’s enabled, your editor, scripts, or AI coding assistants can do such things as create a brand new website, run database upgrades, or submit a preview with out you having to navigate via more than one monitors within the Studio utility.

Getting began with the Studio CLI

To start the usage of the Studio CLI, whole the next steps:

1. Open the WordPress Studio utility to your device.
2. From the principle menu, open the Settings modal. You’ll be able to additionally click on the equipment icon within the top-right nook of the app.
3. Permit the Studio CLI possibility and click on Save.
4. On macOS, you’ll be brought about on your laptop password to permit set up.

As soon as the Studio CLI is enabled, you’ll have get admission to to a world studio command out of your most well-liked terminal utility:

In Studio 1.7.0, the CLI now covers 4 major spaces:

• Authentication: Arrange your WordPress.com account for options that require it
• Preview websites: Create and replace WordPress.com hosted preview websites
• Native website control: Create, get started, prevent, configure, and delete Studio-managed native websites
• WP-CLI integration: Run WP-CLI instructions within as it should be configured Studio environments, with out putting in WP-CLI your self

You’ll be able to see an summary at any time by means of operating studio --help:

Maximum instructions are designed to be run from the basis folder of a Studio-managed website. 

For fast get admission to, you’ll open that folder without delay on your terminal by means of clicking the Terminal button at the website’s Evaluate tab.

Managing native Studio websites

Probably the most greatest upgrades in Studio CLI v2 is end-to-end native website control from the terminal. 

Relatively than switching again to the Studio consumer interface for regimen duties, you’ll create a website, verify its standing, get started or prevent it, and blank it up whilst you’re completed. 

It’s a sooner day by day workflow, and it additionally makes automation a lot more uncomplicated, whether or not you’re writing scripts your self or the usage of an AI agent to do it for you.

On the heart of all of it is the studio website command. The to be had choices come with:

Create native websites with a unmarried command

Use studio website create to spin up a brand new website on your present listing or at a particular trail. Listed here are a couple of examples of what you’ll do:

The CLI will:

• Arrange an area WordPress atmosphere.
• Get started the WordPress server.
• Open WP Admin on your browser when it’s in a position.

You’ll be able to run this from an empty folder, or from a listing that already incorporates a WordPress website that’s not but registered throughout the Studio app.

Listing, check up on, get started, and prevent native websites

When you’re running with more than one native websites, the `record` and `standing` instructions make control a lot more uncomplicated:

Standing output comprises:

• Whether or not the website is operating
• The native URL, for instance http://localhost:PORT
• Key configuration main points equivalent to PHP model and login knowledge

Beginning and preventing websites may be simple:

This works smartly in scripts that want to get started a website, run exams or content material operations, after which prevent it once more.

Delete and configure websites safely

When you’re completed with a undertaking, you’ll take away it from Studio and, if wanted, delete all of the related recordsdata out of your device with the next instructions:

For configuration adjustments, studio website set allows you to modify settings for a particular native website:

You’ll be able to, for instance:

• Exchange the PHP or WordPress model.
• Replace the native area or port.
• Toggle options that have an effect on how the native atmosphere runs.

Tip: Run studio website set --help for the whole record of to be had choices.

Authentication from the terminal

Some Studio options, equivalent to developing or updating preview websites, require a logged-in WordPress.com account. 

Studio CLI v2 will provide you with devoted studio auth instructions so you’ll organize this from the terminal:

• studio auth login launches a browser waft and will provide you with a token to stick again into your terminal to finish the login.
• studio auth standing tells you whether or not you’re authenticated and which account is lively.
• studio auth logout disconnects the CLI out of your WordPress.com account and clears saved credentials.

If you happen to run a command that wishes authentication whilst logged out, equivalent to studio preview create that we can overview subsequent, the CLI will information you to log in.

Preview websites from the CLI

Preview websites are transient, shareable environments hosted on WordPress.com that replicate your native Studio website. They are perfect for sharing paintings with others who shouldn’t have an area atmosphere.

The CLI supplies an entire set of instructions:

Tip: Run studio preview record to peer all previews related along with your WordPress.com account, then use the host price from that output with studio preview replace or studio preview delete.

Integrated WP-CLI, configured for you

WP-CLI is the legitimate command-line interface for WordPress itself. Studio CLI v2 integrates it without delay via a devoted studio wp command, so you don’t want to put in or configure WP-CLI by yourself:

Out of your website’s root listing, you’ll run not unusual WP-CLI duties like:

• studio wp core model presentations the WordPress model for the present website.
• studio wp plugin record lists put in plugins (and their standing).
• studio wp core update-db runs any required database updates after a WordPress replace.

Studio units the surroundings variables, paths, and credentials for you, so those instructions run in opposition to the right kind database and recordsdata without a additional setup.

The use of Studio CLI with AI coding gear

Probably the most greatest benefits of Studio CLI v2 is how naturally it suits into AI-assisted construction workflows, particularly with gear like Claude Code and Cursor. 

Those brokers learn the code on your native undertaking (together with issues and plugins) and run instructions on your atmosphere, which makes it conceivable to dump a lot of the repetitive paintings. For instance, they may be able to:

• Use studio website instructions to create, get started, prevent, and organize native environments.
• Run studio wp for diagnostics, database duties, and content material control.
• Create and replace WordPress.com preview websites for overview with out leaving your editor.

Supply context

The AI software you’re the usage of would possibly not routinely perceive WordPress Studio or the Studio CLI. To get helpful effects, get started by means of giving the AI agent a little of context about what it’s taking a look at and what gear it might probably use.

For instance, consider you’ve opened an area Studio website folder on your terminal. 

Start by means of telling the AI agent what this listing is, and that it might probably run the Studio CLI. 

On this instance, we’ll use Claude Code and explicitly notice that it might probably invoke the CLI by means of studio.

“That is the folder for a WordPress Studio website. You’ve got get admission to to the Studio CLI, which may also be invoked by means of operating studio. Get started by means of exploring the to be had choices.”

From there, you must get a reaction that appears like this:

With a easy recommended, the AI now has a forged working out of the Studio CLI. This case was once generated the usage of Opus 4.5.

Automate atmosphere setup

As soon as the AI understands what Studio can do, you’ll get started handing off regimen setup duties. For example, chances are you’ll inform your agent:

“Arrange a brand new native WordPress website the usage of Studio with the title “Nick’s Website online””

At the back of the scenes, it is going to run one thing like:

Right here’s an instance of the output from Claude Code, once more the usage of Opus 4.5.

Debugging and verification with WP-CLI

Studio additionally makes it simple to troubleshoot problems the usage of WP-CLI — particularly whilst you’re gazing an error and don’t wish to manually search out the reason.

You could say:

“Use the Studio CLI to run WP-CLI assessments and determine why this website is failing, then suggest fixes.”

From there, the agent can:

• Run studio wp instructions (for instance, plugin record, theme record, or core update-db) to gather diagnostics.
• Recommend (or follow) code and configuration adjustments in line with what it unearths.
• Re-run the similar WP-CLI assessments to verify the problem is resolved.

If you happen to haven’t already, take a look at this nice evaluation of WP-CLI to get a way of what it might probably do.

Growing preview websites

Preview websites are probably the most in style options in WordPress Studio, however developing them and holding them up to date can really feel a little tedious for those who’re doing it throughout the Studio consumer interface. 

The CLI streamlines the workflow, and it turns into even more uncomplicated whilst you pair it with an AI agent.

While you’re in a position to percentage your paintings with a consumer or teammate, you’ll merely ask your AI to create a preview website:

“Are you able to spin up a preview website for me?”

If you happen to’re now not already authenticated, the agent will recommended you to log in, then it is going to create the preview and go back the URL. The output must glance one thing like this:

As you proceed running in the community, you’ll periodically ask the agent to replace the preview website. 

If you happen to’re additionally the usage of the AI to assist construct the website, theme, or plugin, you’ll even upload a rule like: after any primary exchange, replace the preview website routinely so your shared hyperlink remains present.

Best possible practices when the usage of AI with Studio CLI

AI brokers may also be extremely efficient copilots whilst you pair them with the Studio CLI. They may be able to accelerate setup, troubleshooting, preview deployments, and run actual instructions in opposition to your atmosphere. 

That stated, somewhat construction up entrance is helping you get the advantages whilst heading off ugly surprises.

• Paintings from the Studio website root (or use `–trail`). This guarantees instructions run in opposition to the undertaking you in fact intend, particularly you probably have more than one websites to your device.
• Set transparent obstacles on your activates. For instance: “Don’t delete websites,” “Simplest run read-only studio wp instructions,” or “Ask sooner than operating database migrations.”
• Double-check damaging operations. For instructions like studio website delete and studio preview delete, have the agent display you the precise instructions it plans to run sooner than it executes the rest.

Used thoughtfully, AI plus Studio CLI can take away a lot of the repetitive setup, checking out, and deployment friction, so you’ll center of attention extra on designing and development nice WordPress reports.

Get started development with Studio CLI

Studio CLI v2 makes WordPress Studio extra scriptable and automation-friendly for on a regular basis construction, whether or not you’re operating instructions your self or running with an AI agent.

If you wish to pass additional, the Studio CLI documentation walks via the entirety you’ll do and the right way to have compatibility it into your workflow.

If you happen to haven’t attempted WordPress Studio but, or it’s been some time, this can be a nice time to leap in. Obtain Studio, spin up a website, and take the up to date CLI for a fast check power.