What problem does it solve?
Provides a repeatable workflow to visually verify UI changes in the BrowserOS agent extension so developers can catch rendering, navigation, and interaction regressions before merging code.
Core Features & Use Cases
- Start the BrowserOS development environment with a fresh profile and randomized ports to avoid conflicts and reproduce first-run behavior.
- Discover extension and page targets via the CDP inspector, and use snapshot versus screenshot strategies to rapidly validate DOM structure, text, and visual layout.
- Interact programmatically with the new tab page and the right side panel (click, fill, press_key, scroll, hover) and verify results using snapshot assertions or screenshots for final visual checks.
- Use cases include verifying new settings pages, ensuring hot-reload updates re-render correctly, testing chat side panel interactions, and diagnosing API or console errors during UI changes.
Quick Start
Start the dev environment with bun run dev:watch -- --new, extract and export the CDP port shown in the output, then run the scripts/dev/inspect-ui.ts inspector to snapshot app.html and sidepanel and verify your UI changes.