The canonical boxcompute/integrations examples
connect popular agent frameworks with the official boxcompute Python SDK or @boxcompute/sdk
TypeScript package. Each example keeps the BoxCompute API key and lifecycle-owned Sandbox ID outside
the model-visible tool schema. Microsoft 365 Copilot is the exception: its declarative plugin
consumes the public OpenAPI contract directly.
To run Amp threads on BoxCompute computers with nothing to install, connect BoxCompute as Amp’s orb provider: see Run Amp threads on BoxCompute.
For local coding agents, the BoxCompute CLI agent skill is the shorter path. It supports Codex CLI, Claude Code, Amp, OpenCode, Cursor, Gemini CLI, GitHub Copilot, Cline, Roo Code, goose, Pi, Windsurf, and other Agent Skills-compatible harnesses without requiring you to write an integration.
Choose a native sandbox or executor adapter when the framework has a suitable contract. Choose a structured command tool when its native sandbox interface is broader, unstable, or would require claiming capabilities the public BoxCompute API does not provide.
The reviewed integrations targeted the non-VM Sandbox path and did not activate VM browser
previews, operator-selected cooperative SSH, or selected-TCP service access. The public API can
create a one-hour bearer HTTP/WebSocket preview for one port on a running network-enabled VM. The
SDKs (0.4.0) expose it as previews.create and previews.close; these adapters do not use it.
Current status
The integration guides are being re-evaluated against the current public API and VM Sandboxes (Beta); they are temporarily unpublished and will be restored here as each is verified. See the canonical boxcompute/integrations repository for the source examples meanwhile.
Hermes in the app
Hermes Agent with VM Sandboxes documents the app’s /hermes
setup flow: reuse or create a VM, install the reviewed release, connect BoxCompute
AI or your own provider, and check a real inference and file read before reporting
ready. This app workflow is separate from the temporarily unpublished framework
adapters above; it does not add Hermes-specific public API, SDK or CLI controls.