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.tasks events
  • Supports slash commands for each agent harness, with a harness.commands event 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/twillaiagentbox-sdk.svg)](https://yunodb.com/tools/twillaiagentbox-sdk?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/twillaiagentbox-sdk?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/twillaiagentbox-sdk.svg" alt="Featured on YunoDB" height="20"></a>