Quickstart

1. Copy .env.example and set DATABASE_URL (Neon or local Postgres).
2. Run pnpm db:generate && pnpm db:migrate && pnpm db:seed.
3. Start the app with pnpm dev.
4. Sign up at /auth/sign-up — you get a private workspace and project.
5. Create an API key, then record a run with curl or the SDK using the live baseUrl.

import { BlackBox } from "@tracebox/sdk";

const recorder = new BlackBox({
  apiKey: process.env.TRACEBOX_API_KEY!,
  projectId: process.env.TRACEBOX_PROJECT_ID!,
  baseUrl: "https://tracebox-ochre.vercel.app",
});

const run = await recorder.startRun({ agent: "demo", version: "1.0.0" });
await run.observe({ text: "hello" });
await run.decision({ action: "respond", rationale: "greeting" });
await run.finish();