Rudel publishes its command surface under wp rudel by default.

You can rename the root command for embedded use by defining RUDEL_CLI_COMMAND before the plugin registers WP-CLI commands.

define( 'RUDEL_CLI_COMMAND', 'sandbox' );

That changes wp rudel create into wp sandbox create. The command behavior does not change.

Status

wp rudel status [--format=<format>]

Shows runtime health, table names, environment counts, and bootstrap state.

Create

wp rudel create --name=<name> [--theme=<slug>] [--clone-from=<id>] [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--ttl-days=<days>] [--expires-at=<timestamp>]

Creates a sandbox. When --clone-from is provided, Rudel clones from another sandbox instead of the host site.

List

wp rudel list [--format=<format>]

Lists sandbox records.

Info

wp rudel info <id> [--format=<format>]

Shows one sandbox record, including lifecycle metadata and worktree metadata when present.

Update

wp rudel update <id> [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--unprotected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--clear-expiry]

Updates lifecycle metadata. It does not rewrite sandbox site content.

Destroy

wp rudel destroy <id> [--force]

Destroys a sandbox, drops its cloned tables, removes managed files, and deletes its runtime record.

Protected sandboxes require --force.

Cleanup

wp rudel cleanup [--force] [--dry-run] [--merged] [--expired] [--format=<format>]

Removes stale sandboxes according to Rudel's cleanup policy.

Logs

wp rudel logs <id> [--tail=<lines>]

Prints a sandbox debug log.

Snapshots

wp rudel snapshot <id> --name=<name>
wp rudel restore <id> --snapshot=<name> [--force]

Snapshots are recovery points for sandbox table state and managed theme files.

Templates

wp rudel template save <id> --name=<name>
wp rudel template list
wp rudel template delete <name>

Templates let you reuse a known sandbox shape for future sandboxes.

Git Push

wp rudel push <id> [--remote=<remote>] [--branch=<branch>] [--message=<message>]

Pushes tracked theme worktree changes through Rudel's PHP-native Git integration.