agent-browser --webgpu launch preset
Introduced 2026-07-13 · score 0.94
HOW TO USE IT
When a browser task needs WebGPU rendering, launch it with `--webgpu` and wait for the app to render before capturing. Run `agent-browser doctor --webgpu` to check rendering and screenshot capture; use `--headed` to probe capture on Windows or Linux.
agent-browser --webgpu open <https://your-webgpu-app.example.com>
agent-browser screenshot <output.png>agent-browser doctor --webgpuagent-browser doctor --webgpu --headedWHY THIS HELPS
When launching a browser session that needs WebGPU rendering, configure the session with the WebGPU preset and probe rendering.
BEFORE THIS CHANGE
Headless Chrome does not expose WebGPU by default; the page can load and screenshots can succeed while the canvas remains black.
REQUIREMENTS AND LIMITATIONS
- Version: v0.31.2
- --webgpu: Enables the WebGPU launch preset; the CLI equivalent of `AGENT_BROWSER_WEBGPU=1` or `"webgpu": true` in agent-browser.json.
- doctor --webgpu (required): Runs render and screenshot checks in a scratch session; screenshot capture is expected to fail headless on Windows and Linux.
- --headed: Shows the browser window; add it to the doctor command to validate capture. On displayless Linux, automatic Xvfb requires Xvfb to be installed and no `DISPLAY` set.
- AGENT_BROWSER_WEBGPU=1: Environment variable to enable the WebGPU launch preset.
- webgpu: Boolean config key in agent-browser.json; `true` enables the WebGPU launch preset. No mutually exclusive config sub-keys are documented.
- Prerequisite: Linux software Vulkan path requires the system Vulkan loader and Mesa ICD: `apt-get install -y libvulkan1 mesa-vulkan-drivers`.
- Prerequisite: Displayless headed Linux screenshot probing requires Xvfb installed; Windows screenshot probing requires a logged-in desktop session.
- Prerequisite: The target page must use a secure context (`https://`, `http://localhost`, or `file://`) for `navigator.gpu`.
- Hardware backends are supported on macOS and Windows; Linux uses software Vulkan.
- Automatic Xvfb applies to displayless headed sessions.
FIRST-PARTY EVIDENCE
- https://github.com/vercel-labs/agent-browser/releases/tag/v0.31.2
- https://github.com/vercel-labs/agent-browser/blob/v0.31.2/skill-data/core/references/webgpu.md
Check the installed version and the source before using it. Entry JSON