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.

Fastest path to a verified first run

Start with opendevbrowser_prompting_guide or opendevbrowser_skill_load opendevbrowser-best-practices "quick start" before low-level browser commands, then load the validated capability lanes when you need the current reliable transcript plus browser replay, desktop observation, research, shopping, and browser-scoped computer-use workflows.

Quickstart
quick-start
opendevbrowser_skill_load opendevbrowser-best-practices "quick start"
opendevbrowser_skill_load opendevbrowser-best-practices "validated capability lanes"
npx opendevbrowser research run --topic "account recovery flow" --source-selection auto --challenge-automation-mode browser --mode json --output-format json
npx opendevbrowser launch --no-extension --headless --start-url https://example.com --output-format json

Install and bootstrap

Choose the installation route that matches your operating model.

npx path

Best for first runs, local trials, and CI smoke checks.

npx opendevbrowser

npm global

Install once for repeated local workflows and shell scripts.

npm install -g opendevbrowser

manual package

Use for pre-release first-run simulation from a local tarball.

npm pack && npm install /path/to/opendevbrowser-<version>.tgz

First-run walkthrough

Three steps to complete an end-to-end run with explicit verification.

Step 1

Install runtime and extension prerequisites for the mode you need (managed, extension, or cdpConnect).

Step 2

Start daemon, verify extension handshake status, then launch/connect and capture a baseline snapshot before actions.

Step 3

Execute actions/workflows, then verify status, diagnostics, cookie policy results, and cleanup state for deterministic completion.

Agent Quick Start

Generated onboarding metadata and generated help drive these first-contact entry points.

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

Command discovery and parity

Keep installed CLI help output aligned with the generated docs, onboarding, and public-surface manifest.

Help inventory

Use both command forms during onboarding validation to confirm parity:

npx opendevbrowser --help npx opendevbrowser help

Reference paths

First-run onboarding and skill-pack guidance are mirrored from the public repo and exposed through these canonical sources.

docs/FIRST_RUN_ONBOARDING.md skills/opendevbrowser-best-practices/SKILL.md

Open Docs Index

Annotation

Capture UI notes, element context, and structured payloads for implementation handoff.

What it does

Annotate live interfaces, attach comments to selected elements, and export payloads plus screenshots for reproducible review.

How to run it

Run the annotate command in managed or extension mode, then validate screenshots and annotation payloads in output artifacts.

Open Annotate Command

Documentation category cards

Generated categories map directly to source-of-truth docs, tool code, and skill definitions in this repository.

Changelog

1 generated pages

Open category

Cli

78 generated pages

Open category

Concepts

3 generated pages

Open category

Extension

2 generated pages

Open category

Guides

6 generated pages

Open category

Installation

1 generated pages

Open category

Quickstart

1 generated pages

Open category

Skills

10 generated pages

Open category

Tools

71 generated pages

Open category

Workflows

3 generated pages

Open category

Troubleshooting preview

Operational friction is documented with explicit checks and recovery commands.

Readiness checks first

Start with status, handshake, and mode checks before executing actions or workflows.

Deterministic recovery

Follow command-level recovery sequences to isolate auth, relay, and target failures quickly.

Auth and cookie controls

Workflow runs can explicitly control session cookie behavior per execution.

No-auth runs

Use `--use-cookies=false` or policy `off` for open browsing and deal-hunting runs that do not require login.

Mixed runs

Use policy `auto` to attempt cookie injection and continue when cookies are unavailable or rejected.

Strict auth runs

Use policy `required`; failures return explicit `auth_required` with structured `cookieDiagnostics` details.

Community and support links

Use docs, repository issues, and release records for support workflows.

Repository

Source code, issues, and releases for implementation truth.

CLI reference

Command-level behavior, flags, and examples from canonical docs.

Troubleshooting

Recovery patterns, diagnostics, and mode-specific operational checks.