Superserve README

Persistent and secure sandboxes for AI Agents, powered by Firecracker microVMs.

apps/
  console/                 # Sandbox dashboard (Next.js 16, App Router)
  ui-docs/                 # UI component docs (Vite)
packages/
  cli/                     # TypeScript CLI (@superserve/cli)
  python-sdk/              # Python SDK (superserve on PyPI)
  sdk/                     # TypeScript SDK (@superserve/sdk)
  ui/                      # Shared UI components (@superserve/ui)
  typescript-config/       # Shared tsconfig presets
  tailwind-config/         # Shared Tailwind config
docs/                      # Mintlify documentation site
tests/                     # SDK end-to-end tests

bun install               # install all JS/TS dependencies
uv sync                   # install all Python dependencies

bun run dev               # start all dev servers
bun run build             # build all packages
bun run lint              # lint all packages
bun run format            # format all files
bun run typecheck         # type check all packages
bun run test              # unit/integration tests

bun run test                                        # unit tests (no credentials)
SUPERSERVE_API_KEY=ss_live_... bun run test:e2e     # e2e against staging