Skip to main content

miles wordpress-detect

Passively checks whether the current folder or --path looks like a local WordPress installation. It does not run WordPress, WP-CLI, plugins, themes, or database checks. The result contains localWordPress, including found, root, detected WP-CLI details, site information when available, plugin information, and next guidance. A detected local site is not permission to use it: ask the user whether to use a Miles design sandbox, that local installation, or another remote site.

miles wordpress-setup

--use local is the explicit local-site setup command. It may install or activate the Miles plugin, connect the local site, and return WordPress and Miles workspace URLs. It does this only after the user chooses local WordPress and the connected Miles service supports local setup. When WordPress needs a manual step, the result includes manualActivationRequired, adminPluginsUrl, milesAdminUrl, actions, and next. Ask the user to complete the WordPress step; do not write plugin credentials or secrets yourself. --use cloud leaves local mode and returns the CLI to design-sandbox mode. It clears the active local selection but keeps the saved pairing so the local site can be used again later. It does not create a design sandbox by itself. The option name is part of the command interface; the user-facing environment is a design sandbox. Remote WordPress sites are not configured through this command. Install and pair the Miles plugin through WordPress.

miles connect-browser

Returns an authenticated workspace url, the normal dashboardUrl, authenticated, connected, connection, and the activeSite. Open the authenticated url, not the plain dashboard URL. Then check until connected is true, or use --wait. --open asks the operating system to open the link. Browser connections can drop when the tab closes or sits idle.

miles convert-theme

Converts a built HTML site into a WordPress block theme in the connected Miles workspace. It needs a browser connection and may take several minutes. Keep the workspace open until it settles. Use it after the HTML site is approved. HTML edits are usually cheaper before conversion; edits to a converted WordPress site can need the browser connection too. Next: Files and export.