← Back to Registry

Sandbox

Bindings File System

Mount a sandbox filesystem and expose process management tools. Works with any Sandbox Agent provider.

1. Install

npm install @rivet-dev/agentos-sandbox sandbox-agent

2. Add to agentOS

Mount the sandbox filesystem and register the process bindings with @rivet-dev/agentos-sandbox.

import { agentOS, setup } from "@rivet-dev/agentos";
import { createSandboxFs, createSandboxToolkit } from "@rivet-dev/agentos-sandbox";
import { SandboxAgent } from "sandbox-agent";
import { docker } from "sandbox-agent/docker";

// Mount the sandbox filesystem and expose its process tools to the VM
const sandbox = await SandboxAgent.start({ sandbox: docker() });

const vm = agentOS({
  mounts: [{ path: "/home/agentos/sandbox", plugin: createSandboxFs({ client: sandbox }) }],
  toolKits: [createSandboxToolkit({ client: sandbox })],
});

export const registry = setup({ use: { vm } });