rwx sandbox

Execute code in a remote sandbox, useful for running complex remote environments or testing untrusted AI-generated code.

An rwx sandbox is a persistent environment that is set up using the same run definitions used for CI/CD, which also means that sandboxes benefit from the same content-based caching, resulting in fast startup of exactly the environment you need for testing.

Sandboxes are uniquely identified by git branch and the absolute path to the config file.

This means that repeated calls to rwx sandbox exec with the same branch and config file will reuse the same sandbox, and if you call rwx sandbox start with the same branch and config file, it will confirm whether you want to use the existing one or start a new one.

To force a fresh sandbox (for example, to re-run setup tasks after changing a dependency), use rwx sandbox exec --reset or rwx sandbox reset.

Sandboxes are designed to work well with coding agents that run in parallel on separate git worktrees, since each worktree will live in its own working directory and therefore can spin up its own sandbox on RWX.

Usage

rwx sandbox <command> [flags]

Subcommands

  • exec - Execute a command in a sandbox
  • init - Initialize a sandbox configuration file
  • list - List sandbox sessions with status
  • reset - Stop and restart a sandbox
  • start - Start a sandbox without executing a command
  • stop - Stop a sandbox session

Global Options

--format <format>

Output format: text or json. Defaults to text.

--json

Output JSON data to stdout. Equivalent to --format json.