Summary

rivet-dev/sandbox-agent simplifies remote control of autonomous coding agents by offering a unified HTTP API and standardized event schema. It enables developers to run agents like Claude Code, Codex, OpenCode, and Amp within isolated sandboxes, abstracting agent-specific interfaces for easier integration, agent swapping, remote management, and session persistence.

How It Works

The system employs a universal adapter architecture. A lightweight Rust daemon within a sandbox exposes an HTTP/SSE API. Each agent has a dedicated adapter translating between the universal API and the agent's proprietary interface. This design provides a consistent control plane and normalized event stream across agents, simplifying development and enabling hot-swapping.

Quick Start & Requirements

Installation uses curl for the server binary or npm/bun for the TypeScript SDK/CLI. The server is a static Rust binary. Dependencies include Node.js/Bun for SDK/CLI. API keys for supported agents are required. Key resources: SDK docs, Deployment guides, OpenAPI Spec.

Highlighted Details

• Universal Agent API: Single interface for Claude Code, Codex, OpenCode, Amp.
• Streaming Events: Real-time SSE for agent actions.
• Universal Session Schema: Normalizes event formats for storage/replay.
• Human-in-the-Loop: Remote approval/denial of agent actions.
• Automatic Agent Installation: Agents installed on-demand.
• Cross-Platform Execution: Runs in Linux-compatible sandboxes (Docker, E2B, Daytona, Vercel).

Maintenance & Community

Roadmap includes Python SDK and auto-configuration. Discord community available.

Licensing & Compatibility

The specific open-source license is not detailed in the README. Compatibility is broad, running on platforms capable of executing Linux binaries.

Limitations & Caveats

Session data storage is consumer responsibility. Does not provide direct LLM wrappers (recommends Vercel AI SDK). No Git management features. Sandbox provider API integration relies on guides.