← screencli  /  docs

The dashboard

The dashboard is where you record on demand and browse everything you've captured. Unlike the GitHub App (which runs automatically on every PR) and the CLI (which runs from your terminal), the dashboard lets you kick off a cloud recording from the browser — no repo, no install, no CI. Type a URL and a prompt, and screencli spins up a cloud browser, drives it, and posts the recording back.

Prerequisites

Record from the browser

The composer sits at the top of the dashboard.

  1. Enter the URL to record — any http(s) address the cloud browser can reach (e.g. https://staging.example.com).

  2. Describe what to record in the prompt box. Be concrete about the flow and any assertion, for example:

    Sign in with demo@example.com and confirm the dashboard loads with no console errors
  3. Press Start Recording (or ⌘/Ctrl + Enter). screencli dispatches a cloud sandbox and takes you to the recording's page, where the status updates live.

Both fields are required. If you're not sure what to type, use one of the Try: suggestion chips under the composer to pre-fill a URL and prompt. Your prompt is the assertion screencli checks — see Writing effective prompts for how to phrase it so you get a real pass/fail.

The Recon toggle

Turn on Recon to run an unrecorded scouting pass first: the agent explores the app to map it, then the main (recorded) run heads straight for the goal. It trades a bit of extra time for a more direct final recording. Recon is experimental — leave it off for simple flows.

Watch a run happen live

After you start a recording, you land on its detail page. While the run is in flight, the video panel shows a live agent feed — each browser action (navigate, click, type, wait, …) appears as the agent performs it, with spoken narration lines called out, and a step counter in the corner. The page polls every few seconds, so a run moves through its phases without a manual refresh:

When the run reaches ready, the live feed is replaced by the playable video.

Your recordings

Below the composer, the Recordings grid shows every recording visible to you — your own, plus any created by teammates who share your workspace. Each card shows a thumbnail, the title (or prompt/URL), duration, view count, and date. Click a card to open its detail page.

Each card carries a status or verdict pill:

Hover a card and click the trash icon to delete a recording (removes both the video and its record). An unlisted tag appears on cards whose visibility isn't public.

Notes & limits