Document Browser Use run-hook demo output

Closes #363.

Author: aaronlab

examples/README.md

@@ -151,6 +151,19 @@ Expect `browsertrace list --limit 5` to show a recent
 two successful steps: `act: click the checkout button` and
 `extract: extract the order total`.
 
+For a no-service Browser Use-shaped run-hook demo, run:
+
+```bash
+BROWSERTRACE_HOME=/tmp/browsertrace-demo python examples/browser_use_run_hooks_demo.py
+BROWSERTRACE_HOME=/tmp/browsertrace-demo browsertrace list --limit 5
+BROWSERTRACE_HOME=/tmp/browsertrace-demo browsertrace show <run_id>
+```
+
+Expect `browsertrace list --limit 5` to show a recent
+`demo: browser-use run hooks flow` run, and
+`browsertrace show <run_id>` to list two successful steps:
+`search_google(query=BrowserTrace)` and `click(selector=#result-1)`.
+
 For Playwright examples, install the browser runtime first:
 
 ```bash

tests/test_metadata.py

@@ -3071,6 +3071,22 @@ def test_examples_readme_links_browser_use_run_hooks_guide():
     assert "Browser Use + LLM" in example_matrix
 
 
+def test_examples_readme_documents_browser_use_run_hooks_expected_output():
+    project_root = Path(__file__).resolve().parents[1]
+    examples_readme = (project_root / "examples" / "README.md").read_text()
+    verification_section = examples_readme.split(
+        "### Quick local verification for a no-service wrapper example", 1
+    )[1].split("For Playwright examples", 1)[0]
+
+    assert "python examples/browser_use_run_hooks_demo.py" in verification_section
+    assert "no-service Browser Use-shaped run-hook demo" in verification_section
+    assert "demo: browser-use run hooks flow" in verification_section
+    assert "search_google(query=BrowserTrace)" in verification_section
+    assert "click(selector=#result-1)" in verification_section
+    assert "browsertrace list --limit 5" in verification_section
+    assert "browsertrace show <run_id>" in verification_section
+
+
 def test_examples_readme_links_stagehand_and_skyvern_guides_near_matrix():
     project_root = Path(__file__).resolve().parents[1]
     examples_readme = (project_root / "examples" / "README.md").read_text()