Surgent is an agentic development workspace that pairs Claude Code with Daytona sandboxes. This monorepo contains everything needed to run the UI, Convex backend, and preview proxy locally or in production.

• Next.js 15, React 19, Tailwind CSS 4 for the front-end (apps/web).
• Convex 1.x with @convex-dev/auth providers for data, auth, and agent orchestration (packages/backend).
• Daytona sandboxes managed through @daytonaio/sdk, fronted by a Cloudflare Worker that proxies previews, dispatches requests, and exposes a /deploy webhook (apps/worker).
• Cloudflare Worker for preview proxying, dispatch routing, and /deploy uploads.

• Chat-first project view that logs timeline updates, todos, and session output in real time.
• Daytona-backed sandbox control: create, resume, or deploy environments with a single mutation.
• Live browser previews proxied through the Cloudflare Worker with automatic Daytona warm-up and token handling.
• One-click deploys: Convex calls the Worker /deploy endpoint to package and push Cloudflare Dispatch workers.
• Drop in credentials for Anthropic Claude, OpenAI, and Google OAuth to enable providers instantly.

• Node.js 18+
• Bun 1.2.20 (packageManager pin)
• Convex CLI (npm i -g convex) and a Convex project/URL
• Wrangler CLI 4.x (bunx wrangler or npm i -g wrangler) for the Cloudflare Worker
• Daytona API credentials with access to the default-web-env:1.0.0 snapshot
• API keys for Anthropic and/or OpenAI, plus Google OAuth client credentials

git clone https://github.com/bahodirr/surgent
cd surgent
bun install

Create these files (or export the same variables in your shell) before running anything:

packages/backend/.env.local

DAYTONA_API_KEY=your-daytona-key
DAYTONA_SERVER_URL=https://app.daytona.io/api
ANTHROPIC_API_KEY=your-anthropic-key
ANTHROPIC_BASE_URL=https://api.anthropic.com
OPENAI_API_KEY=your-openai-key
GOOGLE_CLIENT_ID=your-google-client-id
GOOGLE_CLIENT_SECRET=your-google-client-secret
CONVEX_SITE_URL=https://<your-convex-deployment>.convex.site
CLOUDFLARE_DEPLOY_URL=https://<your-worker-domain>/deploy

apps/web/.env.local

NEXT_PUBLIC_CONVEX_URL=https://<your-convex-deployment>.convex.site
NEXT_PUBLIC_PROXY_URL=localhost:8787

Run bun run --filter @repo/backend setup once to ensure convex dev can reach your Convex deployment and to confirm the site URL.

apps/worker/.dev.vars (loaded by wrangler dev) or remote Wrangler vars/secrets:

DISPATCH_NAMESPACE_NAME=default-surgent-namespace
CLOUDFLARE_ACCOUNT_ID=<your-cloudflare-account-id>
CLOUDFLARE_API_TOKEN=<your-cloudflare-api-token>
DAYTONA_API_URL=https://app.daytona.io/api
DAYTONA_API_KEY=<your-daytona-key>
DEFAULT_SANDBOX_PORT=3000

Set secrets in production with:

wrangler secret put DAYTONA_API_KEY
wrangler secret put CLOUDFLARE_API_TOKEN

• Claude Code (Anthropic) — Set ANTHROPIC_BASE_URL=https://api.anthropic.com and provide an ANTHROPIC_API_KEY created from the Anthropic console. Pass model: "claude-3.5-sonnet" (or any Claude Code variant) when triggering the agent if you want to override the default.
• GLM-4.5 — The backend defaults to glm-4.5 when an Anthropic-compatible endpoint is supplied. Use ANTHROPIC_BASE_URL=https://api.z.ai/api/anthropic and copy the API token from your https://docs.z.ai/scenario-example/develop-tools/claude. Store that value in ANTHROPIC_API_KEY.

bun run dev

This starts convex dev, next dev --turbopack --port 3000, and wrangler dev for the Cloudflare Worker (default preview host https://localhost:8787). Visit http://localhost:3000 to sign in, create a project, and view the live preview served from https://3000-<sandbox-id>.localhost:8787.

Individual dev servers:

bun run --filter @repo/backend dev   # Convex backend
bun run --filter web dev             # Next.js app
bun run --filter worker dev          # Cloudflare Worker (wrangler dev)

bun run lint
bun run check-types
bun run build

• Deploy Convex with bun run --filter @repo/backend deploy.
• Deploy the Cloudflare Worker with bun run --filter worker deploy (or cd apps/worker && bun run deploy).
• Run next build output (apps/web/.next) behind your hosting provider of choice.

Open an issue or pull request with your proposed change. Please run bun run lint and bun run check-types before submitting.