Skip to main content
OpenDevBrowser logoOpenDevBrowser
  • Product
  • Solutions
  • Trust
  • Docs
  • Company
View DocsGet Started
ProductSolutionsTrustDocsCompany
Get StartedDownload Latest Release
OpenDevBrowser logoOpenDevBrowser
  • Docs
  • Security
  • Changelog
  • Download Latest Release
  • View README

Copyright 2026 OpenDevBrowser. MIT License.

Technical architecture with deterministic surfaces

OpenDevBrowser combines managed, extension, and CDP connect modes with browser replay, desktop observation, and browser-scoped computer use in one implementation-ready architecture.

Read Docs
Isometric relay architecture visualization

Runtime architecture map

Browser manager, relay, tools, and workflow modules operate as composable layers.

Managed mode

Launch and control a managed browser process with deterministic lifecycle handling.

Extension ops mode

Operate inside logged-in browser contexts through extension relay surfaces.

Design canvas

Open extension-hosted design tabs, overlays, preview refresh loops, and TSX-first repo code sync from one public surface.

Tool surface

70 tool endpoints cover navigation, interaction, DOM, diagnostics, export, canvas, and workflow surfaces.

CLI surface

77 commands provide script-first operational control across runtime, relay, workflow, and canvas surfaces.

Verification surfaces

Status, traces, logs, and metrics provide confidence gates for each automation run.

Find-it-fast capability map

The generated help surface now exposes the exact operator labels for replay, desktop observation, and browser-scoped computer use.

screencast / browser replay

Use the public browser replay lane when you need temporal browser evidence before or after a fragile flow.

cli: screencast-start, screencast-stop

example: npx opendevbrowser screencast-start --session-id <id> --output-dir ./artifacts/replay

desktop observation

Use the public read-only desktop observation plane for sibling desktop evidence on macOS; availability, window inventory, and accessibility probes use the local swift command, while screenshots use macOS screencapture outside extension relay.

cli: desktop-status, desktop-windows, desktop-active-window, desktop-capture-desktop, desktop-capture-window, desktop-accessibility-snapshot

example: npx opendevbrowser desktop-status --output-format json

computer use / browser-scoped computer use

Control the bounded browser-scoped computer-use challenge lane with --challenge-automation-mode; the optional helper is not a desktop agent.

flag: --challenge-automation-mode off|browser|browser_with_helper

works: research run, shopping run, product-video run, inspiredesign run, macro-resolve --execute

entry: npx opendevbrowser research run --topic "account recovery flow" --source-selection auto --challenge-automation-mode browser --mode json --output-format json

proof: review, session-inspector, workflow fallback metadata

Mode comparison

Choose the right runtime mode for each execution context without changing tool semantics.

Managed

Full lifecycle control with isolated browser process management and deterministic startup behavior.

launch --no-extension

Extension ops

Operate in existing logged-in tabs through relay channels and policy-aware controls.

launch --extension-only

CDP connect

Direct CDP attachment stays available for remote debugging and deterministic browser handoff flows.

connect --ws-endpoint

Tool surface clusters

Feature domains are grouped for predictable implementation paths.

Navigation and interaction

goto, snapshot, click, type, select, scroll, and wait flows.

DOM and extraction

HTML, text, attr/value/state inspection for deterministic extraction logic.

Diagnostics

console, network, trace snapshots, and perf surfaces for regression analysis.

Export and artifact

screenshot, clone page/component, annotate, and rich output pipelines.

Macro and orchestration

macro resolve and workflow wrappers for reusable automation sequences.

Session, targets, and canvas

launch/connect/status plus design-tab preview, feedback events, and repo-backed code-sync controls.

Diagnostics and verification surfaces

Regression-safe operations require observable state at every stage of execution.

diagnostics.sh
opendevbrowser status
opendevbrowser console-poll
opendevbrowser network-poll
opendevbrowser debug-trace-snapshot
opendevbrowser perf

Verification model

Each claim on the landing surface maps to source files, command surfaces, and testable runtime behavior.

runtime + tests + observable outputs

Export and artifact surfaces

Capture outputs for QA, reports, and downstream automation loops.

Screenshots

Collect visual evidence from deterministic browser states.

Clone page/component

Extract reusable front-end structures from live DOM state.

Annotation

Capture structured review metadata with screenshot artifacts.

Workflow integration block

Connect low-level action controls with high-level business workflows.

Composable flow

Launch/action tools feed research, shopping, and product-video wrappers through one deterministic contract.

Policy-aware execution

Per-run cookie controls and structured diagnostics (`auth_required`, `cookieDiagnostics`) keep auth-sensitive workflows predictable.

Go from architecture to execution

Dive into docs for implementation details, command references, and operation patterns.

Read Docs