Simulated OS environments
Desktop Environments
Run macOS, Windows 11, and custom Car OS desktops entirely in the browser. Use them for agent testing, annotation collection, and replay analysis -- all sandboxed with full screenshot capture.
Key Capabilities
Browser-Based Desktops
Full desktop simulations rendered in the browser with no local software required. Annotators and agents interact with realistic OS chrome including dock, taskbar, and native app windows.
Sandboxed Execution
Every environment session runs in an isolated container. Actions cannot escape the sandbox. Sessions are ephemeral by default or can be persisted as snapshots for later replay.
Screenshot Capture
Capture screenshots at every agent step or annotator action. Screenshots are stored in object storage and indexed by session, step number, and timestamp for efficient retrieval.
Snapshot & Replay
Save environment state as a snapshot at any point. Restore snapshots to replay sessions, debug agent behavior, or branch from a known-good state for further annotation.
Usage
curl -X POST https://api.commandagi.com/v1/environments \
-H "Authorization: Bearer $COMMANDAGI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "macos-sonoma",
"resolution": "1920x1080",
"persist": true,
"callbacks": {
"on_screenshot": "https://your-app.com/hooks/screenshot",
"on_complete": "https://your-app.com/hooks/done"
}
}'
# Response
# {
# "id": "env_x7k2m",
# "status": "provisioning",
# "stream_url": "wss://envs.commandagi.com/env_x7k2m/stream",
# "vnc_url": "https://envs.commandagi.com/env_x7k2m/view"
# }