Skip to main content
Early access. Cloud sessions and managed agent runs are not open to every account yet: we are letting accounts in gradually while we test. They run in a cloud sandbox operated by Mutagent, so there is nothing to host. A sandbox with nothing to do for 15 minutes stops; send the session a message and it wakes up, delivers your message and carries on in the same conversation.
Every Helix Cloud run starts a cloud sandbox. These two commands show what a run can choose from: the sandbox provider it runs on, and the preset it starts from. Both lists are the same for every workspace, because sandbox providers are part of the platform. LLM providers and Environments, by contrast, belong to each workspace. You do not need either command to start a run: without a flag, a run uses the default of each. Before you start: install the CLI, sign in (MUTAGENT_API_KEY=<key> mutagent login --json for a coding agent), and select a workspace with mutagent workspaces use <workspace-name>.

​
mutagent sandbox providers

List the sandbox providers that mutagent helix --sandbox-provider <name> accepts, and mark the default.
With --json, the command prints one object:
mutagent-cloud (shown as Mutagent Cloud in the web app) is the platform’s own sandbox provider and the default for every run. A sandbox provider is where a sandbox runs. It is not an LLM provider (mutagent providers) and not an Environment (mutagent env). A run that names a sandbox provider not in this list is refused before anything starts, and the error lists the names you can use. See Sandbox providers.

​
mutagent sandbox presets

List the presets that mutagent helix --preset <name> accepts, and mark the default. A preset is a named sandbox definition kept on the platform: what the sandbox runs, its CPU architecture, and the sandbox provider it runs on.
With --json, the command prints one object:
An unknown preset name is refused before anything starts.

​
In scripts

Read the list before you pass a name, so a run is not refused:

​
If it fails

See CLI errors. mutagent sandbox has other subcommands for running commands in a sandbox directly. Agent tasks use mutagent helix. Run mutagent sandbox --help for the full list.