@nodeops-createos/agentbox
v0.1.1
Published
CreateOS sandbox provider plugin for AgentBox
Maintainers
Readme
@nodeops-createos/agentbox
CreateOS sandbox provider plugin for AgentBox. It runs coding agents in CreateOS Firecracker microVMs using the same AgentBox lifecycle, workspace sync, relay, browser, and service supervision used by the built-in cloud providers.
Requirements
- AgentBox with provider SDK v4 support
- A CreateOS API key
Install
npm install -g @nodeops-createos/agentbox
agentbox plugin add @nodeops-createos/agentbox
agentbox plugin listCreate a box and enter the API key when prompted:
agentbox create --provider createos
agentbox codex --provider createosFor non-interactive use, set CREATEOS_API_KEY in the environment or in
~/.agentbox/secrets.env. CREATEOS_SANDBOX_URL optionally selects a non-default sandbox API
endpoint.
Provider behavior
- Fresh CreateOS rootfs with the AgentBox runtime installed during provisioning
- Native CreateOS pause/resume with an inactivity timeout
- Public preview URLs, VNC, and in-box Docker
- Workspace resync, direct git mode, and orphan pruning
- Interactive PTY attachment through CreateOS's authenticated
shell-wsendpoint; no CLI or SSH - No checkpoint support until CreateOS exposes a compatible snapshot primitive
CreateOS currently cannot bake the local AgentBox runtime into a reusable template. Consequently,
the provider requires credentials but no agentbox prepare step. An optional prepare validates
the API key and runtime assets:
agentbox prepare --provider createosDevelopment
From this repository, with a compatible AgentBox CLI installed:
npm ci
npm run build
npm run typecheck
npm test
agentbox plugin add .
agentbox doctorThe package depends only on @madarco/agentbox-provider-sdk for AgentBox integration. Shared
box-runtime files are resolved from the running CLI, while scripts/ contains only
CreateOS-specific assets.
