Docs Start
Start
Get Runback recording your AI agent. Choose your stack, follow its quickstart, and see your first run in about five minutes.
Choose your quickstart
Each quickstart takes about five minutes and ends with your agent's run open in Runback.
| Your agent is written in… | Quickstart | What you change in your code |
|---|---|---|
| TypeScript or JavaScript | TypeScript | Wrap your model client (2 lines) |
| Python | Python | Wrap your model client (2 lines) |
| Any framework that emits OpenTelemetry (CrewAI, LlamaIndex, Pydantic AI, Google ADK…) | OpenTelemetry | Nothing: set two environment variables |
Using a specific framework such as LangGraph, the Vercel AI SDK or the OpenAI Agents SDK? See Integrations.
Or: send a test run, no code
Not ready to touch your agent? This sends one small sample run from your terminal, so you can see what Runback records before you integrate.
Before you begin
- A Runback account. Create one free.
- A terminal with
curlandbash(macOS and Linux have both; on Windows use WSL).
Get a Runback key
A key tells Runback which workspace a run belongs to. Use a Send only key: it can send runs and nothing else.In the app, open Settings › Keys and access › API key, keep Send only selected, select Generate API key and copy it. It is shown once, and starts
rb_cloud_. Creating keys needs a workspace admin; whoever created the workspace is one.Checking your session…
Send a test run from your terminal
This posts one small, three-event run to Runback with your key. It installs nothing and needs no model key, so it is the quickest way to see a run in your workspace.
terminalShell curl -fsSL https://runback.dev/api/quickstart | RUNBACK_API_KEY="<RUNBACK_API_KEY>" bashExpected output→ Sending a sample agent run to https://runback.dev ... ✓ Run received. View it: https://runback.dev/app/runs/quickstart-<number>Check the run arrived
Open Runs in the app. Your run is at the top, named
quickstart-agent. Open it to step through what the agent did.
Troubleshooting
| You see | What it means | Fix |
|---|---|---|
✗ Runback rejected the key (401) | The key is mistyped, revoked or expired. | Copy the whole key again, or create a new one in Settings › Keys and access › API key. |
RUNBACK_API_KEY: Set RUNBACK_API_KEY to your Runback key | The variable is not set in this terminal. | Put RUNBACK_API_KEY="rb_cloud_…" before bash, as in the step, or export it first. |
| The run is not in Runs | The key belongs to a different workspace. | Check the workspace name in the top right of the app matches the one you created the key in. |