agentbox-sdk
The open-source TypeScript SDK for running AI coding agents in sandboxes. One unified API — swap agents and infrastructure providers without changing your code.
What is agentbox-sdk?
The open-source TypeScript SDK for running AI coding agents in sandboxes. One unified API — swap agents and infrastructure providers without changing your code.
Overview of agentbox-sdk
What it is
AgentBox SDK is an open-source TypeScript SDK for running AI coding agents inside sandboxes. It provides a unified API that allows developers to swap agents and infrastructure providers without changing application code. Unlike wrappers that shell out to CLIs in non-interactive mode, AgentBox launches each agent as a server process inside the sandbox and communicates over WebSocket or HTTP, preserving full interactive capabilities such as approval flows, tool-use control, and streaming events.
Key features
- Supports multiple agents:
claude-code,opencode,codex - Supports multiple sandbox providers:
local-docker,e2b,modal,daytona,vercel - Agents run as server processes inside sandboxes, preserving interactive capabilities
- Provides normalized streaming events via
agent.stream() - Handles background tasks from agents like Claude Code, reporting them through
background.tasksevents - Supports slash commands for each agent harness, with a
harness.commandsevent listing available commands - Allows hosts to end background waits with
run.finishBackgroundWait()
Use cases
- Running AI coding agents in isolated sandbox environments
- Building applications that need to swap between different agents or sandbox providers without code changes
- Automating code generation, review, and project analysis tasks with interactive agent capabilities
- Integrating agent workflows that require background task handling and streaming event consumption
Getting started
bashnpm install agentbox-sdkRequires Node >= 20. The agent CLI you want to use (claude, opencode, codex) should be installed inside your sandbox image.
License and pricing
The license is not stated. The project is listed as open source.
Based on the project's public README and repository metadata.