Managing

List sandboxes

wp rudel list

Use --format=json when another tool needs structured output.

Inspect one sandbox

wp rudel info alpha-3be7

The record includes ID, name, path, status, engine, table prefix, theme, protection, labels, last activity, clone metadata, size, URL and content path.

Update metadata

wp rudel update alpha-3be7 \
  --owner=dennis \
  --labels=qa,agent \
  --purpose="Regression run" \
  --ttl-days=3

Metadata updates do not rewrite sandbox site content. --ttl-days sets the expiry relative to now; --clear-expiry removes it.

Protect a sandbox

wp rudel update alpha-3be7 --protected

Protected sandboxes are skipped by cleanup, both manual and scheduled. Remove protection with --unprotected.

Destroy a sandbox

wp rudel destroy alpha-3be7

The command asks for confirmation. Pass --force to skip the prompt in scripts:

wp rudel destroy alpha-3be7 --force

Protection does not apply here: destroy removes protected sandboxes too.

Destroying a sandbox drops every table with its prefix (including snapshot tables), removes linked worktrees and the sandbox directory, and deletes the Rudel environment record.