Skip to main content
Workspaces are the units you actually use once an environment exists.

​
The Default Workspace

Every environment starts with a workspace named main.
  • main uses the shared /workspace root
  • it has a primary tmux session
  • rmux workspace attach targets it by default

​
Named Workspaces

Named workspaces let you keep parallel work separate. 
rmux workspace new server
rmux workspace new agent-a
rmux workspace new agent-b
For git repos, named workspaces use remote git worktrees. For non-git directories, RMUX creates copied folders instead.

​
Workspace Commands

rmux workspace attach
rmux workspace run bun test
rmux workspace logs
rmux workspace rm agent-a
  • workspace attach opens the workspace terminal
  • workspace run sends a command without attaching
  • workspace logs shows the workspace log output
  • workspace rm removes a named workspace

​
Editors And Workspaces

rmux workspace editor, rmux workspace code, and rmux workspace cursor open the workspace path in a remote editor. They do not attach to the workspace’s tmux terminal. This editor flow currently supports backend=aws and backend=gcp.

Day-To-Day Workflows

See the common workspace commands in context.

Editor Access

See how RMUX sets up VS Code and Cursor over SSH.
Last modified on March 21, 2026