rivet-dev/sandbox-agentAusführen von Coding-Agenten in Sandboxes. Steuerung über HTTP. Unterstützt Claude Code, Codex, OpenCode und Amp.
Ein Server, der in Ihrer Sandbox läuft. Ihre App verbindet sich remote, um Claude Code, Codex, OpenCode, Cursor, Amp oder Pi zu steuern – mit Streaming von Ereignissen, Verwaltung von Berechtigungen und Sitzungen.
Dokumentation — API-Referenz — Discord
Experimentell: Gigacode – Verwenden Sie die TUI von OpenCode mit jedem Coding-Agenten.
Das Remote-Ausführen von Coding-Agenten ist schwierig. Bestehende SDKs setzen lokale Ausführung voraus, SSH zerstört TTY-Handling und Streaming, und jeder Agent hat eine andere API. Von Grund auf neu zu bauen bedeutet, für jeden Coding-Agenten alles neu zu implementieren.
Sandbox Agent löst drei Probleme:
Coding-Agenten brauchen Sandboxen – Sie können KI nicht erlauben, willkürlichen Code auf Ihren Produktionsservern auszuführen. Coding-Agenten benötigen isolierte Umgebungen, aber bestehende SDKs setzen lokale Ausführung voraus. Sandbox Agent ist ein Server, der in der Sandbox läuft und HTTP/SSE bereitstellt.
Jeder Coding-Agent ist anders – Claude Code, Codex, OpenCode, Cursor, Amp und Pi haben jeweils proprietäre APIs, Ereignisformate und Verhaltensweisen. Das Austauschen von Agenten bedeutet, Ihre Integration neu zu schreiben. Sandbox Agent bietet eine einheitliche HTTP-API – schreiben Sie Ihren Code einmal, tauschen Sie Agenten per Konfigurationsänderung aus.
Sitzungen sind flüchtig – Agent-Transkripte leben in der Sandbox. Wenn der Prozess endet, verlieren Sie alles. Sandbox Agent streamt Ereignisse in einem universellen Schema in Ihren Speicher. Persistieren Sie in Postgres, ClickHouse oder Rivet. Später wiederholen, alles prüfen.
Der Sandbox Agent fungiert als universeller Adapter zwischen Ihrer Client-Anwendung und verschiedenen Coding-Agenten. Jeder Agent hat seinen eigenen Adapter, der die Übersetzung zwischen der universellen API und der agentspezifischen Schnittstelle übernimmt.
Wählen Sie die für Ihren Anwendungsfall am besten geeignete Installationsmethode.
Installieren Sie den Skill mit:
npx skills add rivet-dev/skills -s sandbox-agent
bunx skills add rivet-dev/skills -s sandbox-agent
Importieren Sie das SDK direkt in Ihre Node- oder Browser-Anwendung. Vollständige Typsicherheit und Streaming-Unterstützung.
Installation
npm install [email protected]
bun add [email protected]
# Optional: Erlauben Sie Bun, postinstall-Skripte für native Binärdateien auszuführen (erforderlich für SandboxAgent.start()).
bun pm trust @sandbox-agent/cli-linux-x64 @sandbox-agent/cli-linux-arm64 @sandbox-agent/cli-darwin-arm64 @sandbox-agent/cli-darwin-x64 @sandbox-agent/cli-win32-x64
Einrichtung
Lokal (eingebetteter Modus):
import { SandboxAgent } from "sandbox-agent";
const client = await SandboxAgent.start();
Remote (Server-Modus):
import { SandboxAgent } from "sandbox-agent";
const client = await SandboxAgent.connect({
baseUrl: "http://127.0.0.1:2468",
token: process.env.SANDBOX_TOKEN,
});
API-Übersicht
const agents = await client.listAgents();
await client.createSession("demo", {
agent: "codex",
agentMode: "default",
});
await client.postMessage("demo", { message: "Hallo vom SDK." });
for await (const event of client.streamEvents("demo", { offset: 0 })) {
console.log(event.type, event.data);
}
SDK-Dokumentation — Sitzungen verwalten
Führen Sie es als HTTP-Server aus und verbinden Sie sich aus jeder Sprache. Bereitstellung in E2B, Daytona, Vercel oder Ihrer eigenen Infrastruktur.
# Installieren
curl -fsSL https://releases.rivet.dev/sandbox-agent/0.4.x/install.sh | sh
# Ausführen
sandbox-agent server --token "$SANDBOX_TOKEN" --host 127.0.0.1 --port 2468
Optional: Agent-Binärdateien vorinstallieren (kein Server erforderlich; sie werden bei Bedarf lazy installiert, wenn Sie diesen Schritt überspringen):
sandbox-agent install-agent --all
Um die Authentifizierung lokal zu deaktivieren:
sandbox-agent server --no-token --host 127.0.0.1 --port 2468
Schnellstart — Bereitstellungsanleitungen
Installieren Sie den CLI-Wrapper (optional, aber praktisch):
npm install -g @sandbox-agent/[email protected]
# Erlauben Sie Bun, postinstall-Skripte für native Binärdateien auszuführen.
bun add -g @sandbox-agent/[email protected]
bun pm -g trust @sandbox-agent/cli-linux-x64 @sandbox-agent/cli-linux-arm64 @sandbox-agent/cli-darwin-arm64 @sandbox-agent/cli-darwin-x64 @sandbox-agent/cli-win32-x64
Erstellen Sie eine Sitzung und senden Sie eine Nachricht:
sandbox-agent api sessions create my-session --agent codex --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
sandbox-agent api sessions send-message my-session --message "Hallo" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
sandbox-agent api sessions send-message-stream my-session --message "Hallo" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
Sie können auch npx wie folgt verwenden:
npx @sandbox-agent/[email protected] --help
bunx @sandbox-agent/[email protected] --help
Debuggen Sie Sitzungen und Ereignisse mit der integrierten Inspector-UI (z. B. http://localhost:2468/ui/).
API erkunden — Spezifikation ansehen
Oft müssen Sie Ihre persönlichen API-Token verwenden, um Agenten in Sandboxen zu testen:
sandbox-agent credentials extract-env --export
Dies gibt Umgebungsvariablen für Ihre OpenAI/Anthropic/etc API-Schlüssel aus, um sie mit dem Sandbox Agent SDK zu testen.
Nein, sie ergänzen sich. Das AI SDK dient zum Erstellen von Chat-Oberflächen und zum Aufrufen von LLMs. Dieses SDK dient zur Steuerung autonomer Coding-Agenten, die Code schreiben und Befehle ausführen. Verwenden Sie das AI SDK für Ihre UI, und dieses SDK, wenn Sie einen Agenten benötigen, der tatsächlich programmiert.
Claude Code, Codex, OpenCode, Cursor, Amp und Pi. Das SDK normalisiert ihre APIs, sodass Sie zwischen ihnen wechseln können, ohne Ihren Code zu ändern.
Dieses SDK übernimmt keine Persistierung von Sitzungsdaten. Ereignisse werden in einem universellen JSON-Schema gestreamt, das Sie überall persistieren können. Siehe Sitzungen verwalten für Muster mit Postgres oder Rivet Actors.
Beides. Führen Sie es lokal für die Entwicklung aus, stellen Sie es für die Produktion in E2B, Daytona oder Vercel Sandboxen bereit.
Der Server ist ein einzelnes Rust-Binärprogramm, das überall mit einer Curl-Installation läuft. Wenn Ihre Plattform Linux-Binärdateien ausführen kann (Docker, VMs usw.), funktioniert es. Siehe die Bereitstellungsanleitungen für E2B, Daytona und Vercel Sandboxen.
Ja. Verwenden Sie sandbox-agent credentials extract-env, um API-Schlüssel aus Ihren lokalen Agentenkonfigurationen (Claude Code, Codex, OpenCode, Amp, Pi) zu extrahieren und an die Sandbox-Umgebung zu übergeben.
Rust liefert uns ein einzelnes statisches Binärprogramm, schnellen Start und vorhersehbare Speichernutzung. Dadurch lässt es sich leicht in Sandboxen oder in CI ausführen, ohne eine große Laufzeit wie Node.js mitzuliefern.
Das können Sie für die Entwicklung. Aber in der Produktion benötigen Sie Isolation. Coding-Agenten führen willkürlichen Code aus – das kann nicht auf Ihren Servern passieren. Sandboxen bieten die Isolation; dieses SDK bietet die HTTP-API zur Fernsteuerung von Coding-Agenten.
Offizielle SDKs setzen lokale Ausführung voraus. Sie starten Prozesse und erwarten interaktive Terminals. Dieses SDK führt einen Server in einer Sandbox aus, mit dem Sie über HTTP verbinden – von Grund auf für die Fernsteuerung konzipiert.
Coding-Agenten erwarten interaktive Terminals mit ordnungsgemäßer TTY-Behandlung. SSH mit weitergeleiteten Befehlen unterbricht Tool-Bestätigungen, Streaming-Ausgaben und Human-in-the-Loop-Abläufe. Das SDK erledigt all dies über eine saubere HTTP-API.
| Komponente | Beschreibung |
|---|
| Server | Rust-Daemon (sandbox-agent server), der die HTTP + SSE API bereitstellt |
| SDK | TypeScript-Client mit eingebettetem und Server-Modus |
| Inspector | Integrierte UI zum Inspizieren von Sitzungen und Ereignissen |
| CLI | sandbox-agent (gleiches Binärprogramm, plus npm-Wrapper) spiegelt die HTTP-Endpunkte |