Sandbox
Watch your agent work in real-time. Browse workspace files, monitor activity, and manage workflows — all from the Sandbox tab.
What is the Sandbox?#
The Sandbox is your window into your agent's VM. It shows the files your agent creates and modifies, a live activity feed of filesystem changes, and gives you access to the workflow builder and execution history. Access it from the Sandbox tab in the dashboard.
Files
Browse your agent's workspace filesystem in real-time. Expand directories, click files to preview, and see file sizes.
Workflows
Create, manage, and run automated multi-step workflows. Build from scratch or use templates.
Executions
Track workflow run history with step-by-step results, status indicators, and error details.
Files Tab#
The Files tab shows your agent's workspace as a live, expandable file tree. As your agent creates, modifies, or deletes files, the tree updates automatically. Click any file to preview its contents in the built-in viewer.
File Tree#
The left panel shows your agent's workspace directory structure. Click folders to expand them and click files to open them in the viewer. File sizes are displayed next to each file name so you can quickly gauge content at a glance.
File Viewer#
When you select a file, it opens in the viewer panel with syntax-appropriate formatting. The viewer shows the file path, detected language, and the full file content. Close the viewer by clicking the X button in the top-right corner.
Activity Feed#
The activity feed (below the viewer on desktop, or in its own tab on mobile) shows real-time filesystem events. Each event includes a timestamp, event type, and the affected file path.
| Event Type | Color | Description |
|---|---|---|
| Created | Green | A new file or directory was created |
| Modified | Amber | An existing file was updated |
| Deleted | Red | A file or directory was removed |
Auto-Refresh#
By default, the Sandbox polls your agent's workspace every 3 seconds. You can toggle auto-refresh on or off using the Auto button in the top-right corner. The manual Refresh button fetches the latest state immediately.
Performance
Requirements#
The Sandbox requires your agent to be online and running a recent bridge version that supports the workspace file API.
Rebuild Required
Workflows & Executions