CAPABILITY · OBSERVABILITY

Watch the agent run live — and replay the recording later

Stream the browser session in real time, then keep a durable video of every run for debugging, audit, and proof of what happened.

GET /api/v1/runs/{id}/live
Built for the cost wedge

What live view & session video does

Headless automation is a black box until it breaks. Twin streams a live view of the browser as the agent works, and records each session to durable storage so you can scrub back through exactly what the agent saw and did. Observability is built in, not bolted on.

Real-time live view

Watch the cursor move, pages load, and steps execute as they happen — from the dashboard or the API.

Durable session video

Every run is recorded and stored durably, so you can replay it long after the run finished.

Tied to the step list

The video is aligned with the run's step list, so a failure jumps you straight to the frame where it happened.

Proof for audits

A recording plus machine-readable headers is concrete evidence of what an authorized run actually did.

How it works

From a goal to deterministic action

  1. 1Start a runKick off a goal or a skill; Twin opens a real browser session for it.
  2. 2Stream liveSubscribe to the live view to watch the session render in real time.
  3. 3Record to storageThe session is captured and written to durable storage as it runs.
  4. 4Replay anytimeFetch the saved video and step list later for debugging, demos, or audit.
In practice

See it on a real call

Subscribe to a live stream while the agent runs, then fetch the durable recording and step list afterward.

observe.tsts
const run = await twin.agents.run({ goal, url });

// Watch it happen
const live = twin.runs.live(run.id);     // real-time stream

// …or replay it later
const { videoUrl, steps } = await twin.runs.get(run.id);
// → durable mp4 + aligned step list
api.twin-browser.com
  1. Start a rundone
  2. Stream liverunning
  3. Record to storagequeued
  4. Replay anytimequeued
At a glance

What live view & session video is

The facts — how it works, what it costs, and the signal you get back on every call.

PropertyTwin Browser
Live viewReal-time session stream
RecordingPer-run session video
StorageDurable object storage
AlignmentSynced to step list
AccessDashboard + API
UseDebug, demo, audit
FAQ

Live view & session video — common questions

Can I watch a run while it happens?
Yes. Twin streams a real-time live view of the browser session from both the dashboard and the API.
How long are recordings kept?
Session videos are written to durable storage and retained so you can replay them well after the run completes.
How does video help debugging?
The recording is aligned to the run's step list, so a failed step jumps you straight to the moment it happened.

Make every run cheaper than the last.

Start free, compile your first skill, and watch the marginal cost per run trend toward zero as your agents reuse what they have already learned.