A server runs inside your sandbox. Your app connects remotely to control agents, stream events, handle permissions, and manage sessions.
Every agent has different APIs, event formats, and permission flows. Sandbox Agent handles those differences so your application can use one interface.
Start sessions, send prompts, handle permissions, and stream events through a single interface. Swap agents without rewriting your integration.
Receive events as the agent works. Store the conversation in your own database for replay, auditing, and session restoration.
A lightweight Rust server runs inside your sandbox. Connect from your application over HTTP, or use the TypeScript SDK locally.
Read and write files, run commands, and attach to terminals alongside your coding agent.
Configure skills, MCP servers, and custom tools for your agents through the same SDK.
Use OpenCode tooling to control supported agents through the experimental compatibility API.
Deploy on E2B, Daytona, Vercel, Cloudflare, Docker, Modal, or your own infrastructure.
Install the TypeScript SDK, start a server, and send your first prompt.
npm install sandbox-agent@0.4.xThey work together. AI SDK helps you build chat interfaces and call language models. Sandbox Agent controls coding agents that write code and run commands.
Claude Code, Codex, OpenCode, Cursor, Amp, and Pi. The SDK normalizes their APIs so you can swap agents without changing your integration.
Session events use a shared schema that you can store in your own database. The persistence guides cover IndexedDB, SQLite, Postgres, and Rivet.
Yes. Run locally for development or deploy the server inside a sandbox. The same SDK supports both.
The server is a Rust binary that runs in Docker, virtual machines, and sandbox providers. The docs include deployment guides for E2B, Daytona, Vercel, Cloudflare, Modal, and more.
Yes. Supply your own provider credentials, or use sandbox-agent credentials extract-env to extract credentials from your local agent configuration.
Rust provides a single binary, fast startup, and predictable memory usage, so the server can run inside sandboxes and CI without a separate application runtime.
Coding agents run commands and change files. A sandbox isolates those operations from your application servers. Sandbox Agent supplies the API for controlling the agent remotely.
Official SDKs typically run local processes. Sandbox Agent runs a server inside the sandbox so your application can control those processes over HTTP.
Coding agents need streaming output, interactive terminals, and permission handling. Sandbox Agent exposes these capabilities through an application API.