rivet-dev/sandbox-agentEsegui Agenti di programmazione in sandbox. Controllali tramite HTTP. Supporta Claude Code, Codex, OpenCode e Amp.
Un server che gira all'interno della tua sandbox. La tua app si connette da remoto per controllare Claude Code, Codex, OpenCode, Cursor, Amp o Pi: trasmette eventi, gestisce permessi, amministra le sessioni.
Documentazione — Riferimento API — Discord
Sperimentale: Gigacode — usa la TUI di OpenCode con qualsiasi agente di codifica.
Eseguire agenti di codifica da remoto è difficile. Gli SDK esistenti presuppongono l'esecuzione locale, SSH rompe la gestione del TTY e lo streaming, e ogni agente ha una API diversa. Costruire da zero significa reimplementare tutto per ogni agente di codifica.
Sandbox Agent risolve tre problemi:
Gli agenti di codifica hanno bisogno di sandbox — Non puoi lasciare che l'AI esegua codice arbitrario sui tuoi server di produzione. Gli agenti di codifica hanno bisogno di ambienti isolati, ma gli SDK esistenti presuppongono l'esecuzione locale. Sandbox Agent è un server che gira all'interno della sandbox ed espone HTTP/SSE.
Ogni agente di codifica è diverso — Claude Code, Codex, OpenCode, Cursor, Amp e Pi hanno API proprietarie, formati di eventi e comportamenti diversi. Cambiare agente significa riscrivere la tua integrazione. Sandbox Agent fornisce una API HTTP unica: scrivi il codice una volta, cambia agente con una modifica di configurazione.
Le sessioni sono effimere — I trascritti degli agenti vivono nella sandbox. Quando il processo termina, perdi tutto. Sandbox Agent trasmette eventi in uno schema universale verso il tuo storage. Persisti su Postgres, ClickHouse o Rivet. Riproduci in seguito, esegui audit di tutto.
Sandbox Agent agisce come un adattatore universale tra la tua applicazione client e vari agenti di codifica. Ogni agente ha il proprio adattatore che gestisce la traduzione tra l'API universale e l'interfaccia specifica dell'agente.
Documentazione sull'architettura
| Componente | Descrizione |
|---|---|
| Server | Demone Rust (sandbox-agent server) che espone l'API HTTP + SSE |
| SDK | Client TypeScript con modalità incorporata e server |
| Inspector | UI integrata per ispezionare sessioni ed eventi |
| CLI | sandbox-agent (stesso binario, più wrapper npm) che replica gli endpoint HTTP |
Scegli il metodo di installazione più adatto al tuo caso d'uso.
Installa skill con:
npx skills add rivet-dev/skills -s sandbox-agent
bunx skills add rivet-dev/skills -s sandbox-agent
Importa l'SDK direttamente nella tua applicazione Node o browser. Piena sicurezza dei tipi e supporto allo streaming.
Installazione
npm install [email protected]
bun add [email protected]
# Opzionale: consenti a Bun di eseguire script postinstall per binari nativi (richiesto per 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
Configurazione
Locale (modalità incorporata):
import { SandboxAgent } from "sandbox-agent";
const client = await SandboxAgent.start();
Remota (modalità server):
import { SandboxAgent } from "sandbox-agent";
const client = await SandboxAgent.connect({
baseUrl: "http://127.0.0.1:2468",
token: process.env.SANDBOX_TOKEN,
});
Panoramica API
const agents = await client.listAgents();
await client.createSession("demo", {
agent: "codex",
agentMode: "default",
});
await client.postMessage("demo", { message: "Ciao dall'SDK." });
for await (const event of client.streamEvents("demo", { offset: 0 })) {
console.log(event.type, event.data);
}
Documentazione SDK — Gestione delle sessioni
Esegui come server HTTP e connettiti da qualsiasi linguaggio. Distribuisci in E2B, Daytona, Vercel o nella tua infrastruttura.
# Installalo
curl -fsSL https://releases.rivet.dev/sandbox-agent/0.4.x/install.sh | sh
# Eseguilo
sandbox-agent server --token "$SANDBOX_TOKEN" --host 127.0.0.1 --port 2468
Opzionale: preinstalla i binari degli agenti (non richiesto; verranno installati lazy al primo utilizzo se salti questo passaggio):
sandbox-agent install-agent --all
Per disabilitare l'autenticazione in locale:
sandbox-agent server --no-token --host 127.0.0.1 --port 2468
Guida rapida — Guide alla distribuzione
Installa il wrapper CLI (opzionale ma comodo):
npm install -g @sandbox-agent/[email protected]
# Consenti a Bun di eseguire script postinstall per binari nativi.
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
Crea una sessione e invia un messaggio:
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 "Hello" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
sandbox-agent api sessions send-message-stream my-session --message "Hello" --endpoint http://127.0.0.1:2468 --token "$SANDBOX_TOKEN"
Puoi anche usare npx come:
npx @sandbox-agent/[email protected] --help
bunx @sandbox-agent/[email protected] --help
Esegui il debug di sessioni ed eventi con l'UI Inspector integrata (es. http://localhost:2468/ui/).
