CLI Reference

Name: WP Launcher
Author: MSR Builds

CLI Commands

The wpl CLI is installed globally during setup. Run wpl with no arguments to launch the interactive terminal dashboard.

Command	Description
`wpl`	Launch interactive terminal dashboard
`wpl start`	Start all Docker Compose services
`wpl stop`	Stop all services
`wpl restart`	Restart all services
`wpl rebuild`	Rebuild and restart services after code changes
`wpl status`	Show service status
`wpl logs [service]`	Tail logs for a service (api, provisioner, traefik, etc.)
`wpl sites`	List all active WordPress sites
`wpl open`	Open dashboard in browser
`wpl open mail`	Open Mailpit email testing UI
`wpl open <subdomain>`	Open a specific site in browser
`wpl shell <subdomain>`	Bash into a site's container
`wpl wp <subdomain> <command>`	Run WP-CLI command inside a site
`wpl build:wp`	Rebuild WordPress base images
`wpl dir`	Print the WP Launcher install directory
`wpl version`	Show version and git commit
`wpl update`	Pull latest code, rebuild, and restart
`wpl help`	Show help text

Admin Commands

Command	Description
`wpl admin:promote <email>`	Promote a user to admin role
`wpl admin:demote <email>`	Demote an admin to regular user

WP-CLI Examples

# List plugins on a site
wpl wp coral-sunset-7x3k plugin list

# Install a plugin
wpl wp coral-sunset-7x3k plugin install contact-form-7 --activate

# Export the database
wpl wp coral-sunset-7x3k db export - > backup.sql

# Create a user
wpl wp coral-sunset-7x3k user create editor [email protected] --role=editor

# Update WordPress
wpl wp coral-sunset-7x3k core update

npm Scripts

Alternative to the wpl CLI — run from the project root:

Script	Description
`npm start`	Start all services
`npm stop`	Stop all services
`npm run rebuild`	Rebuild and restart
`npm run status`	Show service status
`npm run logs`	Tail all service logs