Skip to content

Integration guides

Connect supported agent frameworks to BoxCompute Sandboxes.

Updated View as Markdown

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.

Navigation

Type to search…

↑↓ navigate↵ selectEsc close