Skip to main content
This page covers the environment-level commands around rmux new.

​
Create The Environment

rmux new
rmux new --no-attach
rmux env new
  • rmux new creates the environment, syncs the current directory, creates main, and attaches to it.
  • rmux new --no-attach skips the final attach step.
  • rmux env new is the namespace form of the same create command.

​
Inspect The Current Environment

rmux env status
rmux workspace ls
rmux env status shows the current binding, provider details, runtime state, last sync time, and workspace information.

​
List Other Visible Environments

rmux env list
rmux usage
  • rmux env list shows environments visible to the current backend.
  • rmux usage gives a backend-wide summary of environments and workspaces.
Both commands print environment IDs, which are useful when you need to target an environment from another directory.

​
Stop Or Destroy

rmux env down
rmux env destroy
  • rmux env down stops remote compute while preserving environment state.
  • rmux env destroy removes the environment entirely and clears the local binding when it matches.
You can also target another visible environment by exact name or ID: 
rmux env down env_123
rmux env destroy my-project
rmux env down --all
rmux env destroy --all
If multiple environments share the same name, RMUX fails instead of guessing.

​
Retryable Destroy

Destroy is retryable. If cleanup partially fails, RMUX keeps the environment record, shows the cleanup state in rmux env status, and lets you rerun rmux env destroy.
Last modified on March 21, 2026