Quick start
From zero to a running sandbox on a local kind cluster in under five minutes.
Documentation
go-runtime-sandbox reference docs. The site root has the marketing pitch; this section is the practical guide.
Start here
New to the project? → Quick start gets you from zero to a running cmd/demo against a local kind cluster in under five minutes.
Want to deploy on GKE? → Install walks through enabling the agent-sandbox addon, pushing images, and applying the right kustomize overlay for the Validating Admission Policy.
Wiring up an LLM? → MCP server covers registration in Claude Code, Gemini CLI, and any other stdio-MCP client.
Trying to understand the design? → How it works covers the three execution layers, the multi-file upload mechanism, lifecycle decisions, and the gotchas we hit during real-world testing.
Reference index
- Quick start — the one-script kind path.
- Install — kind walkthrough, full GKE recipe, runtime-class overlays, warm-pool tuning, troubleshooting.
- MCP server — the
run_go_codetool, registering it in Claude Code and Gemini CLI, sample prompts. - How it works — design and rationale (formerly
docs/design.mdin the repo).
Install
Run the demo on kind or GKE — prerequisites, manifest overlays, warm pool, troubleshooting.
MCP server
Registering the run_go_code tool with Claude Code or Gemini CLI, the tool schema, sample prompts.
How it works
Design and rationale: the three execution layers, the multi-file upload mechanism, lifecycle decisions, gotchas from real-world testing.