record-video

# record-video Use this skill when a UI verification depends on interaction over time: opening menus, clicking through flows, dragging, typing, navigation, loading states, transitions, or animation. ## Key Facts Use `agent-browser record` as the primary recorder. Record directly to an `.mp4` path so `agent-browser` encodes the recording as a silent MP4 that can be uploaded with `upload-media`. ## Required Workflow 1. Open the target page with `agent-browser open`. 2. Set the viewport explicitly when layout matters. 3. Use `agent-browser snapshot -i` to inspect accessible names/selectors before recording. 4. Start recording with `agent-browser record start <path>.mp4`. 5. Perform the interaction being verified. 6. Always run `agent-browser record stop`. 7. Use `ffprobe` to read actual encoded dimensions and duration before upload. 8. Report the returned `artifactId` and what interaction was verified. ## Command Pattern ```bash set -e agent-browser open "$URL" agent-browser set viewport 1512 982 agent-browser snapshot -i STARTED_AT_MS=$(date +%s%3N) agent-browser record start /tmp/opencode/demo.mp4 recording_started=1 cleanup_recording() { if [ "${recording_started:-0}" = "1" ]; then agent-browser record stop || true fi } trap cleanup_recording EXIT interaction_exit_code=0 agent-browser click "[data-testid=settings]" || interaction_exit_code=$? agent-browser wait 1000 || interaction_exit_code=$? agent-browser record stop recording_started=0 trap - EXIT ENDED_AT_MS=$(date +%s%3N) PROBE_JSON=$(ffprobe -v error -print_format json -show_streams -show_format /tmp/opencode/demo.mp4) DURATION_MS=$(node -e 'const p=JSON.parse(process.argv[1]); const v=(p.streams||[]).find((s)=>s.codec_type==="video")||{}; const d=Number(v.duration ?? p.format?.duration); console.log(Math.max(1, Math.round(d * 1000)));' "$PROBE_JSON") DIMENSIONS=$(node -e 'const p=JSON.parse(process.argv[1]); const v=(p.streams||[]).find((s)=>s.codec_type==="video")||{}; console.log(JSON.stringify({width:Number(v.width),height:Number(v.height)}));' "$PROBE_JSON") upload-media /tmp/opencode/demo.mp4 \ --artifact-type video \ --caption "What this recording verifies" \ --source-url "$URL" \ --duration-ms "$DURATION_MS" \ --recording-started-at "$STARTED_AT_MS" \ --recording-ended-at "$ENDED_AT_MS" \ --dimensions "$DIMENSIONS" \ --truncated false \ --has-audio false exit "$interaction_exit_code" ``` ## Guardrails - Do not leave a recording active. Always run `agent-browser record stop` after starting. - Do not claim a video was uploaded unless `upload-media` returned an artifact ID. - Keep recordings short and focused on the behavior being verified. - Prefer stable selectors such as `[data-testid=...]`, `[data-clear-completed]`, or `#todo-title`. Avoid fragile text selectors when labels contain apostrophes or dynamic text. - Do not use requested viewport dimensions as video dimensions. Use `ffprobe` metadata from the encoded MP4. - If a recording command fails, run `agent-browser record stop` to clear any active recording, then upload any available MP4.