Documentation (main)
Bleeding-edge docs from the main branch.
These docs track git main and may describe unreleased features. Prefer the latest release unless you are developing grain itself.
Find features fast
| Want… | Go here |
|---|---|
| Desktop GUI | Grain Desktop — sandboxes, recipes, warm pool, activity, multi-Run |
| Recipe library | Sandbox recipes — ~/.grain/recipes, official catalog, deploy |
| Fast creates | Lifecycle / warm pool — --from, --from-pool, suspend |
| Firecracker | Firecracker on Linux · Hypervisor matrix |
| First shell | Quick start · First sandbox |
| act / k3s | act · k3s |
| MCP agents | MCP overview |
- Developer
- Explain
- Get started — Install grain, open a first sandbox, recipes, or jump to Desktop / Firecracker.
- Guides (how-tos by job) — Problem-oriented how-tos for everyday use and operating grain in production-like setups.
- MCP server (coding agents) — Connect Claude Code, Cursor, Codex, Grok Build, and other MCP hosts to grain sandboxes.
- Reference (CLI, API, SDKs, config)