Introduction

RemoteMux turns the directory you are in into a persistent remote workspace. Work runs on a long-lived cloud environment with tmux sessions that survive disconnects, laptop sleeps, and Wi-Fi drops.

Quick Start

Launch your first environment and attach to a remote workspace.

Use AI Agents

Run Claude Code, Codex, or any CLI agent on a persistent remote VM.

Choose a Backend

Compare AWS, GCP, E2B, and Managed backends.

Troubleshooting

Fix failed checks, missing credentials, attach problems, and sync issues.

Core Concepts

Concept	What it means
Directory binding	RemoteMux binds the current local directory to one remote environment in `.rmux/state.json`. Re-entering the same folder lets RemoteMux find the right environment automatically.
Environment	The long-lived remote compute and `/workspace` for one project. `env down` stops compute without deleting state; `env destroy` removes it entirely.
Workspace	An isolated checkout in the environment with a `tmux` session. You can keep `main`, `server`, and agent workspaces running in parallel without conflicts.
Backend	The infrastructure provider (AWS, GCP, E2B, or Managed). The RemoteMux model stays the same across all backends.

Last modified on March 30, 2026

Quick Start

Getting Started

Core Concepts

Guides

Backends

Reference

Quick Start

Use AI Agents

Choose a Backend

Troubleshooting

Core Concepts

Quick Start

Use AI Agents

Choose a Backend

Troubleshooting

​Core Concepts

Core Concepts