Environments

Overview of Browser, Linux, and Windows environments for agent execution

Asteroid agents run inside isolated sandboxes. The environment type determines how the agent interacts with the target system.

Choose an environment

Use the pages below to pick the environment that matches your workload:

Browser

Headless Chromium with DOM tools, scripts, and optional CUA.

Linux

Full Linux desktop for native apps and non-browser workflows.

Windows

Windows desktop for Windows-only enterprise software.

Quick comparison

Environment	Best for	Interaction mode
Browser	Web apps and sites in Chromium	DOM tools + scripts + optional CUA
Linux	Browser plus Linux-native desktop workflows	CUA desktop control
Windows	Windows-only desktop software	CUA desktop control

---

Shared conventions

Regardless of environment type, every sandbox uses the same /home/agent directory layout (shared/, workspace/, downloads/, uploads/), so file handling and tool behaviour stay consistent. See Files for details.

Files

Directory layout and file API access

AI Capabilities

Tools and capability identifiers

Profiles

Credentials and environment configuration