Skip to main content
Record a single tab to video — an audit trail of what the agent saw — while the run keeps going. Recording rides the tab’s screencast feed, so it works headless or headed and never steals frames from snapshots. CLI and cURL examples use $RT and browser b1 (Sessions).

Start and stop

recording_start(target_id) begins a per-tab screencast and returns {recording_id, path, started} — optional fps and quality tune the feed. recording_stop(target_id) finalizes it to an .fmp4 artifact inside the runtime. recording_export copies a finished artifact to any workspace directory you choose and returns {paths, bytes} — grab it from there with runtime.files.download.
This records the page, not the desktop — for the whole screen use desktop recording. Both write artifacts into the guest filesystem; export paths are confined to the workspace.