# Bindings

## Sandbox

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

| Category | Status | Package | Docs |
| --- | --- | --- | --- |
| Bindings, File System | Available | [`@rivet-dev/agentos-sandbox`](https://www.npmjs.com/package/@rivet-dev/agentos-sandbox) | [Guide](/agentos/docs/sandboxes) |

### Install

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

### Add to agentOS

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

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

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

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

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