Get started with froog

Quicksand sandboxes for AI agents, Pushbox GitHub Actions runners and Tokenmail inboxes, driven from the froog CLI, the HTTP API, SDKs or an MCP server.

$ curl -fsSL https://froogcorp.com/install | sh
$ froog login
$ froog new my-box          # about 20 s
$ froog exec my-box -- 'uname -a'
$ froog stop my-box         # stops billing
from froogdev import Froog

froog = Froog()  # FROOG_API_KEY from the environment
with froog.sandboxes.create(size="small") as sb:
    r = sb.exec("uname -a", timeout=60)
    print(r.stdout, r.exit_code)
import { Froog } from "froogdev";

const froog = new Froog({ apiKey: process.env.FROOG_API_KEY });
await using sb = await froog.sandboxes.create({ size: "small" });
const r = await sb.exec("uname -a", { timeout: 60 });
$ curl -s https://api.froogcorp.com/v1/sandboxes \
    -H "Authorization: Bearer $FROOG_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "ci-1", "size": "small"}'

Products

froog Quicksandfroog new

A full Linux VM for every agent, with SSH, Docker, Chrome, a desktop and a disk that persists.

Small
2 vCPU · 4 GB · $0.0137/h
Default
4 vCPU · 8 GB · $0.0274/h
Start
~20 s to SSH
OS
Ubuntu, Debian, Omarchy
froog Pushboxruns-on: froog

GitHub Actions runners: every job in a fresh VM of its own, billed per second.

Price
$0.0006 / vCPU-minute
2 vCPU
$0.0012 / min
8 vCPU
$0.0048 / min
Billed
job time only
froog Tokenmail Newfroogmail.com

Inboxes for agents: sign up for a service, then read the one-time code or link.

Price
$2 / inbox a month
Receives
codes, links, full messages
Sends
nothing
Plan
its own subscription

Jump straight in

Sandboxes, forks, agents, Pushbox and Tokenmail, from the command line or your code.

$ froog new my-box --size large --os debian
$ froog ssh my-box
$ froog exec my-box -- 'git clone https://github.com/you/app && cd app && make test'
$ froog new box --ttl 4h       # stops 4 hours after each start
$ froog info box
sb = froog.sandboxes.create(size="large", os="debian", keep=True)
sb.files.write("app.py", "print('hi')")
for e in sb.exec_stream("make test"):
    print(e.get("data", ""), end="")

Full Linux VMs

Ubuntu 24.04 or 26.04, Debian 13 or Omarchy, with SSH, Docker, Chrome, coding agents and a disk that persists.

  • Its own kernel, on bare metal
  • small, default, large and xlarge sizes
  • An auto-stop timer, 1 hour by default
  • Billed per second while it runs
Read docs
$ froog snapshot my-box --name before-upgrade
$ froog snapshots my-box                        # list
$ froog fork my-box@before-upgrade my-box-2     # new sandbox from a snapshot
$ froog fork my-box try --count 5               # try-1 … try-5
$ froog restore my-box@before-upgrade           # roll back in place

Snapshots and forks

Snapshot a VM, fork it into many, or roll it back in place.

  • Automatic snapshots hourly and on every stop
  • Saved snapshots kept until you delete them
  • Fork one VM into several with --count
  • Share a snapshot with a share code
Read docs
$ froog onboard          # sign in, SSH key, agent keys, a first sandbox, a first prompt
$ froog new agent-1
$ froog desktop agent-1  # watch the desktop in a browser

Coding agents, ready to run

Claude Code, Codex, OpenCode, Gemini CLI and more are installed in every VM, with a desktop and computer use.

  • Your agent keys, or the AI proxy
  • A desktop with computer use over MCP
  • froog as an MCP server for your own agent
  • Framework guides for the popular SDKs
Read docs
jobs:
  test:
    runs-on: froog          # was: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm test
# GitLab CI, CircleCI, Buildkite: a fresh VM with this folder, the command, then it is deleted
$ froog run -- make test

GitHub Actions runners

Change one line and every job runs in a fresh VM of its own.

  • $0.0006 per vCPU per minute
  • Billed per second of job time
  • 2, 4 or 8 vCPU runners
  • Or froog run from any other CI
Read docs
$ froog inbox create --username signup --name "acme trial"
$ froog inbox wait signup-k3f9qz@froogmail.com --code
$ froog inbox wait signup-k3f9qz@froogmail.com --link --from acme
$ froog inbox messages signup-k3f9qz@froogmail.com

Inboxes for agents

An address on froogmail.com that an agent signs up with, then reads the code or link itself.

  • $2 per inbox a month
  • Receive only, nothing can be sent
  • Waits for a code or a verification link
  • No sandbox plan needed
Read docs

Explore the docs

All the docs as one Markdown file: froogcorp.com/docs.md. What's new: the changelog (RSS).