groundbox migrate
Rewrites runs-on in every workflow.
- One command
- --dry-run prints the diff
- No other YAML changes
One door for your agents. Groundbox runs GitHub Actions jobs and Linux sandboxes for coding agents. One API key, one bill.
Free: 3,000 CI minutes a month·Paid: $20 a month, $20 of usage included·Billed by the second
Paste one prompt into Claude Code, Cursor or Codex. Your agent installs Groundbox, you approve the sign-in in your browser, and it starts its first sandbox. It offers faster CI if you're in a repo.
Set up Groundbox (groundbox.dev) for me: Linux sandboxes you can use, and faster GitHub Actions runners. Docs written for agents: https://groundbox.dev/llms.txt 1. Install the CLI: npm i -g @groundbox/cli 2. Run groundbox login. It opens a page in my browser where I sign up or sign in and approve. If you can't open a browser, give me the link it prints. 3. Show me it works: groundbox run -- "uname -a && node -v && python3 --version" 4. If you're Claude Code, add the MCP server so you can use sandboxes in later sessions: claude mcp add --transport http groundbox https://mcp.groundbox.dev/mcp 5. If this folder is a GitHub repo with workflows in .github/workflows, ask me whether I want faster CI. If I do, run groundbox tuneup <owner/name> and give me the pull request it makes. If it needs the Groundbox GitHub App first, give me the link to install it. Tell me what you did in a few lines, and what it cost (groundbox usage).
The first time your agent uses it, you sign in and approve in the browser. No key to paste. Free to start, no card.
CI jobs about 2× faster than GitHub's runners at the same size·4-core jobs start in about 1 s·Measured on 10 open-source projects
Rewrites runs-on in every workflow.
A fresh Firecracker VM for every job. Destroyed when the job ends.
Waits for CI and returns pass or fail. On failure, the failing step's log.
Mirrors and build caches next to the job. No workflow changes.
Fork a running sandbox. Files and processes are copied.
A paused sandbox pays for storage only. Memory and disk are kept. Stop keeps the disk only, at the same rate.
A Linux VM for each agent. Dedicated cores. $0.04 per vCPU-hour.
Scopes limit what it can do.
A monthly cap on each key. The key can't raise it.
No rounding up to the minute. 4 vCPU is $0.006 a minute.
See what each job does, and make it cheaper.
Caches, builders and a place to keep what they make.
Save, rewind, schedule and share a sandbox.
What an agent needs to work on its own, within limits you set.
Every feature through all four. SDKs in TypeScript and Python.
Free to start, with everything included: $5 of usage and 3,000 CI minutes a month, no card. Then $20 a month, with $20 of usage included.
| Product | Price |
|---|---|
| CI runners | from $0.003 a minute |
| Sandboxes | $0.04 per vCPU-hour |
Billed by the second. Annual: 2 months free.
| What does Groundbox cost? | Free: everything, with $5 of usage and 3,000 CI minutes a month, no card. $20 a month: $20 of usage included, then pay as you go. CI runners cost from $0.003 a minute and sandboxes $0.04 per vCPU-hour. |
| Is there a free plan or a free trial? | Yes, a free plan with every feature: $5 of usage and 3,000 CI minutes a month, with no card. Until a card is on file, sandboxes are held to 2 sandboxes at a time, 2 vCPU, 4 GB, 1 hour each. |
| How do I move GitHub Actions jobs to Groundbox? | Install the Groundbox GitHub App, then change runs-on: ubuntu-latest to runs-on: groundbox-4vcpu. groundbox migrate rewrites every workflow for you. No other YAML changes. |
| What is a sandbox? | A Linux VM that an agent starts by API, MCP, CLI or SDK. It runs commands and keeps files, and you can fork, pause and resume it. |
| How does an agent sign up? | With groundbox signup, POST /v1/signup or the MCP sign-up endpoint. It gets a key on the free plan, with the same free credit, and a claim link; a person opens the link to take the account over. |
| How are jobs and sandboxes isolated? | Each CI job and each sandbox runs in its own Firecracker VM. A job's VM is new for that job and destroyed when it ends. Caches are kept per team. |
| Is usage billed by the second? | Yes, with no rounding up to the minute. A 90-second job on 4 vCPU costs $0.009. |
| Can I cancel at any time? | Yes. The plan runs to the end of the period you paid for. The current period and prepaid credit are not refunded, except where the law requires. |
| Which platforms do the runners support? | Linux x64 only, at 2, 4, 8 and 16 vCPU. There are no macOS, Windows or ARM runners. |
| Can I limit what an agent spends? | Yes. Each API key has scopes and a monthly spend cap, and the key can't raise its own cap. |
| How fast are the runners? | CI jobs ran about 2× faster than GitHub's runners at the same size, measured on 10 open-source projects. Method and scripts are on the benchmark page. |