Skip to main content

​
Before You Begin

You need AWS credentials, the AWS CLI, and the AWS Session Manager plugin.
1

Configure and validate the backend

From inside the project you want to bind:
Not sure which backend to use? See Choose a Backend.
2

Create the environment

This provisions the environment and binds the current directory to it.
3

Bootstrap the project workspace

Syncs the current directory into /workspace, restores Git state, and creates the default main workspace.
Use rmux env sync later to push local changes into the environment without reprovisioning.
4

Attach and work

You are now in a remote tmux session. Start Claude Code, run tests, or do anything you would in a local terminal.Press Ctrl+B, then D to detach. The session keeps running.
5

Stop or destroy when done

​
What To Do Next

Use AI Agents

Run Claude Code or Codex on a persistent remote workspace.

Configuration

Config files, environment variables, and backend-specific settings.

Workflow Patterns

Day-to-day workspace commands and common patterns.

Troubleshooting

Fix preflight, attach, sync, or binding issues.
Last modified on April 9, 2026