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.
Use these commands to check the Helix build that cloud sandboxes run, for example before you report a problem. Before you start: install the CLI and sign in (MUTAGENT_API_KEY=<key> mutagent login --json for a coding agent), and select a workspace with mutagent workspaces use <workspace-name>. doctor and smoke start a temporary cloud sandbox, so your account needs cloud sandboxes enabled. smoke runs one real model turn, so the workspace needs a default model: see mutagent helix models.

​
mutagent helix version

Show this CLI’s version and the Helix version that cloud sandboxes run. mutagent helix --version prints the same. For the Helix on your machine, run helix --version.
The Helix version is the one the cloud image is released with, as the server reports it. With --json, the output is { cli, helix, helixSource }.

​
mutagent helix doctor

Run Helix’s diagnostics in a new cloud sandbox. The sandbox is removed afterwards. The command exits with Helix’s exit status, so a failed check fails the command. It checks the cloud image, not your machine: for your local Helix, run helix doctor.
With --json, the output is { success, command, result: { sandboxId, exitCode, stdout, stderr, timedOut, tornDown } }. Success is exit code 0 with result.exitCode 0. On a failure, read result.stdout and result.stderr; result.timedOut is true when Helix did not finish in time. --refresh-runtime is refused: the cloud image has no Helix runtime to refresh.

​
mutagent helix smoke

Run Helix’s smoke test in a new cloud sandbox: one real model turn. The sandbox is removed afterwards. The command exits with Helix’s exit status.
With --json, the output has the same shape as mutagent helix doctor --json.

​
mutagent helix update

Not available in the cloud: the command refuses and names the Helix version the cloud image runs. The release sets that version. To update the Helix on your machine, run helix update.

​
If it fails

See CLI errors and Troubleshooting cloud runs.