Bring Your Own Cloud
You provide your Hetzner API token. VMs run on your infrastructure, billed to your account. The platform never stores your cloud credentials as environment variables.
What is SAM?
Simple Agent Manager (SAM) is an open-source platform for running ephemeral AI coding agent environments. It provisions cloud VMs, sets up devcontainers, and gives you a browser-based terminal with Claude Code pre-installed.
Why SAM?
Section titled “Why SAM?”AI coding agents need real development environments — not sandboxes. SAM gives each agent its own VM with a full Linux environment, Docker, and git, accessible through a web terminal.
Serverless Control Plane
The API runs on Cloudflare Workers — zero infrastructure to manage. D1 for storage, KV for sessions, R2 for binaries.
Ephemeral by Design
Workspaces spin up in minutes and tear down when you’re done. No persistent VMs burning money overnight.
Self-Hostable
Fork the repo, configure a GitHub Environment, push to main. Automated deployment via Pulumi + GitHub Actions.
How It Works
Section titled “How It Works”- Sign in with GitHub via the web UI
- Add your Hetzner token in Settings
- Install the GitHub App on your repositories
- Create a workspace — SAM provisions a VM, clones your repo, starts a devcontainer
- Use the terminal — browser-based xterm.js with WebSocket connection to the VM
- Chat with Claude — built-in agent chat powered by Claude Code
Architecture at a Glance
Section titled “Architecture at a Glance”SAM is a monorepo with four main components:
| Component | Technology | Purpose |
|---|---|---|
| API | Cloudflare Worker (Hono) | Authentication, resource management, VM proxying |
| Web UI | React + Vite (Cloudflare Pages) | Dashboard, terminal, agent chat |
| VM Agent | Go binary | Docker management, PTY sessions, ACP gateway |
| Infrastructure | Pulumi (TypeScript) | D1, KV, R2, DNS provisioning |
Quickstart Get up and running with SAM in minutes.
Architecture Overview Deep dive into how every system fits together.