Capsule is an interactive, host-side installer (wizard.sh) that turns any empty folder into a reproducible devcontainer: it generates the .devcontainer/ config, wires up agent hooks, deploys a decision log and a persistent task board, handles GPU/NPU/iGPU passthrough, and verifies the container actually attaches before it declares success.

Use it when

You want to let an AI agent write code, install packages, and run shell commands with broad permissions without handing it your real machine — a disposable, rebuildable, network-isolated container that still opens straight into a VSCodium window.

  • Sandbox for Claude Code, Grok, or any LLM coding agent
  • No Docker daemon, no root daemon — rootless Podman only
  • Deterministic setup: no clashing ports, names, or paths
  • NVIDIA / AMD GPU, NPU, and iGPU passthrough, auto-configured

Source & full docs on GitHub