agentbox github ↗
npm @madarco/agentbox license MIT envs Local Docker · Vercel · Hetzner · Daytona os macOS · Linux
// self-hosted agent sandboxes

One command teleport
for agents, in parallel.

Move your project into a dedicated VM — local or in the cloud — and launch Claude Code, Codex, or Open Code inside it. Each box is isolated, checkpointed, and runs on hardware you control.

$ npx @madarco/agentbox claudecodexopencode
full install instructions
actions
Host your machine
HTTP tunnels.localhost · portless
teleport ▸
VM Box isolated
/workspaceawaiting sync…synced · two-way
~/.claudeawaiting inject…injected · sessions
Code
VS Code / Cursor
Browser
Chromium
webVNC
live screen
Docker-in-Docker
DB
Services
// click workspace or .claude on the host to teleport it into the box — or hit the teleport ▸ arrow to send everything
01

How it works

Teleport

Move your project to a dedicated VM — local or in the cloud — with a single command.

Automatic

Brings all your skills, plugins, and settings for Claude Code, Codex, and Open Code.

Full computer

Dedicated browser, screen sharing, persistent shells and a warmed-up VS Code / Cursor IDE in every box.

Checkpoints

Sub-1s startup from a previous checkpoint. Auto-pause to save cost and resources when idle.

Safe

Git credentials stay on your local machine. Pushing to a remote always goes through an explicit permission request.

02

The CLI

create & run
agentbox createCreate and start a new agent box.
agentbox claudeCreate a sandboxed box and launch Claude Code in a detachable tmux session.
agentbox <provider> claudeLaunch sandboxed boxes on Vercel, Hetzner, Daytona or local Docker.
agentbox <provider> codexSame, for Codex and Open Code — any agent, any provider.
agentbox claude attach 2Reattach to a running Claude session on box 2.
access
agentbox urlOpen a box's web app URL in the browser.
agentbox screenOpen a box's VNC (noVNC) viewer.
agentbox codeOpen a box in VS Code or Cursor via Dev Containers.
agentbox shellOpen an interactive bash shell in a box.
agentbox dashboardBox list plus the selected box's live agent session.
lifecycle
start / stopStart or stop a box, preserving its upper volume.
pause / unpauseFreeze or resume a box — sub-second.
destroyDestroy a box and discard its upper volume.
checkpointList and manage warm box-state checkpoints.
03

Providers

local or remote
capabilitylocal dockerhetznerdaytonavercel
supportfullfullpartialfull
base imageDockerfilesetup script (Ubuntu)Dockerfilesetup script
live snapshotsyesyesexperimentalyes
private preview urlsportless · orbstackportlessnativenative
04

Install

$ npm -g i @madarco/agentbox && agentbox install

The first agentbox create builds the agentbox/box:dev image (~1 GB, one-time). Uses portless to give box web apps the same URL inside the box and on the host.

requirements

  • macOS or Linux — arm64 or Intel
  • Docker — Desktop or OrbStack
  • Node >=20.10