BrowserTrace v0.1.17

BrowserTrace v0.1.17 packages the latest Stagehand evidence improvements and launch-surface cleanup.

Highlights:

• Adds compact stagehand_evidence summaries for Stagehand observe/action-shaped results, including selectors, descriptions, and methods when available.
• Keeps Stagehand optional and dependency-free in BrowserTrace tests.
• Improves standalone HTML exports with responsive viewport metadata and narrow-screen layout.
• Keeps the deterministic no-API demo and public-safe export assets for quick inspection.

Install from PyPI:

pip install "browsertrace[ui]"
browsertrace doctor
browsertrace demo
browsertrace

No-install PyPI trial:

uvx --from "browsertrace[ui]" browsertrace demo

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.16

BrowserTrace v0.1.16 completes the PyPI launch cleanup.\n\nHighlights:\n\n- BrowserTrace is now published on PyPI with Trusted Publishing.\n- README, launch copy, PyPI metadata, llms.txt, and guide quickstarts now use the public PyPI install path.\n- browsertrace doctor now points missing UI dependency guidance to pip install "browsertrace[ui]".\n- The release keeps the deterministic no-API demo and public-safe export assets for quick inspection.\n\nTry from PyPI:\n\nbash\npip install "browsertrace[ui]"\nbrowsertrace doctor\nbrowsertrace demo\nbrowsertrace\n\n\nNo-install PyPI trial:\n\nbash\nuvx --from "browsertrace[ui]" browsertrace demo\n\n\nUse browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.15

BrowserTrace v0.1.15 adds a Browser Use run-hook helper while PyPI publishing is still waiting on owner-side Trusted Publisher setup.

Highlights:

• Added create_run_hooks for Browser Use apps that pass on_step_start and on_step_end directly to agent.run(...).
• The run-hook helper records Browser Use history and browser-session summaries when available: latest thought, action, extracted content, URL, title, tabs, and screenshot flag.
• Kept the existing attach_tracer(agent, ...) path for Browser Use agents that expose register_new_step_callback or compatible callback attributes.
• Refreshed README, Browser Use guide, launch kit, llms.txt, and release links to the pinned v0.1.15 tag.

Try before PyPI:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.15" browsertrace

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.14

BrowserTrace v0.1.14 packages the latest Browser Use and Stagehand integration improvements while PyPI publishing is still waiting on owner-side Trusted Publisher setup.

Highlights:

• Browser Use adapter now records compact browser-state context in model_input, including step count, URL, title, tabs, and whether a screenshot was captured.
• Browser Use guide now documents callback compatibility and troubleshooting paths for callback-style and run-hook-only apps.
• Stagehand wrapper now records successful act, extract, observe, goto, and click return values as step model_output.
• PR template and security reporting docs were clarified for safer contributor onboarding.

Try before PyPI:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.14" browsertrace

Use browsertrace export <run_id> --public -o public.html before posting real traces publicly.

BrowserTrace v0.1.13

BrowserTrace v0.1.13 is a launch-readiness patch for first-run onboarding.\n\n- Fixes browsertrace doctor so missing UI dependency guidance points to the current GitHub release-tag install path while PyPI publishing is still pending.\n- Adds README troubleshooting notes for common first-run doctor states such as Database: missing and Runs: 0.\n- Updates README, launch packets, guides, llms.txt, and owner-action docs to use v0.1.13.\n\nTry it before PyPI is enabled:\n\nbash\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo\nuvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace\n\n\nLive demo: https://aaronlab.github.io/browsertrace/\nPublic-safe export: https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo-public.html\nLaunch discussion: #6

BrowserTrace v0.1.12

BrowserTrace v0.1.12 aligns the GitHub tag install path with the latest launch docs, computer-use guide, and runnable examples.

Highlights:

• Added a custom computer-use debugging guide for generic observe-decide-act browser-agent loops.
• Added examples/computer_use_loop_example.py, a no-browser/no-API example for custom computer-use agents.
• Added copy buttons to the core guide quickstarts so users can run the GitHub tag demo with less manual selection.
• Updated GitHub install and uvx launch copy to point at v0.1.12.

Useful links:

• Live demo: https://aaronlab.github.io/browsertrace/
• Computer-use guide: https://aaronlab.github.io/browsertrace/computer-use-agent-debugging.html
• Debugging walkthrough: https://aaronlab.github.io/browsertrace/debug-browser-agent-failure.html
• Public-safe demo export: https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo-public.html
• Good first issue: #23
• Public-safe export docs issue: #25
• Launch discussion: #6

Try without PyPI while Trusted Publisher setup is still pending:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace list
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace

Release assets include the wheel, sdist, full demo HTML export, public-safe demo export, demo video, poster, and GIF.

BrowserTrace v0.1.11

BrowserTrace v0.1.11 adds a first-run diagnostic command for lower-friction launch testing.

Highlights:

• Added browsertrace doctor to print Python version, BrowserTrace home, database status, run/step counts, UI dependency availability, and the next command to run.
• doctor works even before a trace database exists, so new users can verify their install before running the demo.
• Updated GitHub install and uvx launch copy to point at v0.1.11.

Try without PyPI while Trusted Publisher setup is still pending:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace doctor
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace list
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.11" browsertrace

Release assets include the wheel, sdist, full demo HTML export, public-safe demo export, demo video, poster, and GIF.

BrowserTrace v0.1.10

BrowserTrace is a local flight recorder for AI browser agents. It records failed Browser Use, Stagehand, Skyvern, Playwright + LLM, and custom computer-use runs as a timeline of screenshots, URLs, actions, model I/O, status, and errors.

Start here:

• Live demo: https://aaronlab.github.io/browsertrace/
• Debugging walkthrough: https://aaronlab.github.io/browsertrace/debug-browser-agent-failure.html
• Integrations: https://aaronlab.github.io/browsertrace/integrations.html
• Browser Use guide: https://aaronlab.github.io/browsertrace/browser-use-debugging.html
• Stagehand guide: https://aaronlab.github.io/browsertrace/stagehand-debugging.html
• Skyvern guide: https://aaronlab.github.io/browsertrace/skyvern-debugging.html
• Playwright + LLM guide: https://aaronlab.github.io/browsertrace/playwright-llm-debugging.html

What changed in v0.1.10:

• Added browsertrace export --public as a single public-safe export mode.
• --public omits prompt/model I/O, screenshots, and URLs from standalone HTML exports.
• Kept --redact, --redact-screenshots, and --redact-urls for selective sharing.
• Added release assets for both a full demo export and a public-safe redacted export.
• Updated README, walkthroughs, launch copy, and release links for v0.1.10.

Try it with pip:

pip install "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.10"
browsertrace demo
browsertrace

No-install uvx trial before PyPI publishing is enabled:

uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.10" browsertrace demo
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.10" browsertrace list
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.10" browsertrace

Then open http://127.0.0.1:3000 and inspect the failed checkout-agent run.

Public sharing workflow:

browsertrace list
browsertrace export <run_id> --public -o public.html

Release assets:

• browsertrace-demo.html: full exported trace.
• browsertrace-demo-public.html: public-safe redacted export.
• demo.mp4 and demo-poster.png: launch/demo media.
• Wheel and sdist for manual installation before PyPI publishing is enabled.

Feedback wanted:

• What state do you wish you had when a browser agent failed?
• Which adapter should be deeper next: Browser Use, Stagehand, Skyvern, Playwright + LLM, or another computer-use stack?

Discussion: #6
Issues: https://github.com/aaronlab/browsertrace/issues

BrowserTrace v0.1.9

BrowserTrace v0.1.9

This release improves public sharing controls for exported traces.

Added

• browsertrace export --redact-urls to omit step URLs from exported HTML traces.
• Sharing docs now show prompt/model I/O, screenshot, and URL redaction together.

Usage

browsertrace export <run_id> --redact -o public.html
browsertrace export <run_id> --redact --redact-screenshots --redact-urls -o public.html

Verification

• uv run --python 3.11 --extra dev pytest -q -> 66 passed.
• uv build produced wheel and sdist.
• CI passed on Python 3.11, 3.12, and 3.13.

BrowserTrace v0.1.8

BrowserTrace v0.1.8

This release improves public sharing controls for exported traces.

Added

• browsertrace export --redact-screenshots to omit screenshots from exported HTML traces.
• Sharing docs now distinguish prompt/model I/O redaction from screenshot redaction.

Usage

browsertrace export <run_id> --redact -o public.html
browsertrace export <run_id> --redact --redact-screenshots -o public.html

Verification

• uv run --python 3.11 --extra dev pytest -q -> 65 passed.
• uv build produced wheel and sdist.
• CI passed on Python 3.11, 3.12, and 3.13.