Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.remotemux.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Before You Begin

curl -fsSL https://remotemux.com/releases/install.sh | bash
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:
cd /path/to/project
rmux login

rmux configure --backend aws --from-aws-cli
rmux aws-check
Not sure which backend to use? See Choose a Backend.
2

Create the environment

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

Bootstrap the project workspace

rmux workspace new main
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

rmux workspace attach
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

rmux env down       # stop compute, preserve state
rmux env destroy    # remove entirely

​
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