Start

Getting started

From an empty organisation to a first supervised run in about ten minutes.

You need a web application to test (staging is ideal), a model key from any supported provider, and a browser. Nothing is installed on your side.

1. Create an organisation

Sign up with your email. You become the owner and can invite teammates from Settings → Team. Invites are emailed and also shown as a link you can paste.

2. Add the application under test

Settings → Environments → Add. An environment has:

  • Base URL, where runs start.
  • Allowed origins. The agent may only navigate within these; anything else needs approval. Defaults to the base URL's origin.
  • Readiness signal. A selector plus attribute and value (for example body / data-loaded / true) that says the page has hydrated. It replaces fixed sleeps in replay. If your app has no such attribute, add one; it is a one-line change that removes a whole class of flakes.
  • Secrets, by name. The agent emits a placeholder such as {{secret:password}}. The runner substitutes the value at keystroke time, only on the allowed origins. The value is never shown again and never reaches a model.
  • Destructive flag. On destructive environments an expired takeover parks the run for a human instead of returning control to the agent.

3. Bind a model

Settings → Providers → Add. Pick Anthropic, Google or OpenAI-compatible, paste the base URL if the provider needs one, the key and the model id. Handoff probes what the model can do (tool calling, JSON mode, vision) and shows the result; you can override it. See Bring your own model.

4. Start a run

On the dashboard, write a goal in plain language and start the run. The run page opens with the live browser. Watch, pause, take control if the agent needs help, and hand back. When the run finishes, the steps it took and any steps you recorded by hand are on the page, ready to review.

5. Replay and export

“Re-run recorded steps” replays the test with no model calls. “Export as Playwright” downloads a standalone spec. To run it locally:

BASE_URL=https://staging.example.com SECRET_PASSWORD=… npx playwright test tc-0001.spec.ts
The control lease →
Getting started · Handoff