Reference
Sandbox
Mount a Sandbox Agent (Docker) filesystem into the VM and expose its process management as bindings.
Back a VM with a real Sandbox Agent container: the sandbox’s filesystem appears as a mount inside the VM, and its process management is callable as bindings. Reach for this when you want guest code to read, write, and run against a live Docker sandbox instead of the in-memory VFS.
How it works
The server passes docker() as the sandbox provider. Each actor VM gets its own Docker sandbox, mounted under /home/agentos/sandbox, plus a sandbox binding collection surfaced as the agentos-sandbox CLI command. Disposing the VM destroys its sandbox.
Run it
npm install
npm run server # starts the VM with the sandbox mount + bindings
npm run client # writes a file, runs it, and streams process output
You should see hello printed from a file executed inside the Docker sandbox.