Skip to content

Commit ddabb75

Browse files
aaronlabaaronlab
committed
fix: point doctor ui install to release tag
1 parent 2082f19 commit ddabb75

35 files changed

Lines changed: 215 additions & 170 deletions

‎CHANGELOG.md‎

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,17 @@ UTC.
55

66
## Unreleased
77

8-
- Refreshed the roadmap and launch queues with the current `v0.1.12` release,
8+
- Refreshed the roadmap and launch queues with the current `v0.1.13` release,
99
open awesome-list PR status, and remaining owner-only blockers.
1010
- Clarified the first-contribution path for good-first issues and PR templates.
1111

12+
## 0.1.13 - 2026-05-09
13+
14+
- Updated `browsertrace doctor` so missing UI dependency guidance points to the
15+
current GitHub release tag while PyPI publishing is still pending.
16+
- Added a first-run `browsertrace doctor` troubleshooting note to the README.
17+
- Updated launch, guide, and owner-action docs to point at `v0.1.13`.
18+
1219
## 0.1.12 - 2026-05-09
1320

1421
- Added a custom computer-use debugging guide and a no-browser

‎LAUNCH.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# BrowserTrace Launch Control Room
22

33
Canonical repo: https://github.com/aaronlab/browsertrace
4-
Current release: `v0.1.12`
4+
Current release: `v0.1.13`
55
Owner account: `aaronlab`
66

77
## Current State
@@ -14,10 +14,10 @@ Owner account: `aaronlab`
1414
- If posting before PyPI is live, use the tested no-install `uvx` fallback:
1515

1616
```bash
17-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
18-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
19-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace list
20-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace
17+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
18+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
19+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace list
20+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace
2121
```
2222

2323
- Current audited star count should be checked before every public push:
@@ -30,8 +30,8 @@ gh repo view aaronlab/browsertrace --json stargazerCount,url,homepageUrl,owner
3030
- README animation: `docs/demo.gif`
3131
- Static poster: `docs/demo-poster.png`
3232
- Live zero-install demo: https://aaronlab.github.io/browsertrace/
33-
- Downloadable demo trace: `browsertrace-demo.html` attached to release `v0.1.12`
34-
- Public-safe demo trace: `browsertrace-demo-public.html` attached to release `v0.1.12`
33+
- Downloadable demo trace: `browsertrace-demo.html` attached to release `v0.1.13`
34+
- Public-safe demo trace: `browsertrace-demo-public.html` attached to release `v0.1.13`
3535
- Launch discussion: https://github.com/aaronlab/browsertrace/discussions/6
3636

3737
## Day 0 Asset Checklist

‎README.md‎

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -39,16 +39,21 @@ Use this before PyPI publishing is enabled. The quickest path is `uvx` from the
3939
GitHub release tag:
4040

4141
```bash
42-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
43-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
44-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace list
45-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace
42+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
43+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
44+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace list
45+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace
4646
```
4747

4848
If you see `uvx: command not found`, install `uv` from the
4949
[official uv installation guide](https://docs.astral.sh/uv/getting-started/installation/),
5050
or use the persistent GitHub-tag `pip install` path below.
5151

52+
`browsertrace doctor` is safe to run before any trace exists. On a fresh
53+
machine, `Database: missing` and `Runs: 0` mean setup is working and the next
54+
step is `browsertrace demo`. If it reports missing UI dependencies, install the
55+
release tag with `[ui]` as shown below; PyPI publishing is still pending.
56+
5257
Open `http://127.0.0.1:3000`, click
5358
`demo: checkout agent fails on disabled button`, and inspect the failed step.
5459

@@ -59,20 +64,20 @@ tag:
5964

6065
```bash
6166
# SDK only
62-
pip install "browsertrace @ git+https://github.com/aaronlab/browsertrace@v0.1.12"
67+
pip install "browsertrace @ git+https://github.com/aaronlab/browsertrace@v0.1.13"
6368

6469
# SDK + local web UI
65-
pip install "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12"
70+
pip install "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13"
6671
browsertrace doctor
6772
browsertrace demo
6873
browsertrace
6974
```
7075

7176
Want to inspect an exported trace before installing anything? Open the
7277
[live static demo](https://aaronlab.github.io/browsertrace/) or download
73-
[`browsertrace-demo.html`](https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo.html)
78+
[`browsertrace-demo.html`](https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo.html)
7479
or the public-safe
75-
[`browsertrace-demo-public.html`](https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo-public.html)
80+
[`browsertrace-demo-public.html`](https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo-public.html)
7681
from the latest release.
7782

7883
For a walkthrough, read
@@ -260,7 +265,7 @@ For AI summaries before PyPI publishing is enabled, install the `ai` extra from
260265
the release tag you are using:
261266

262267
```bash
263-
pip install "browsertrace[ui,ai] @ git+https://github.com/aaronlab/browsertrace@v0.1.12"
268+
pip install "browsertrace[ui,ai] @ git+https://github.com/aaronlab/browsertrace@v0.1.13"
264269
```
265270

266271
```bash

‎browsertrace/__init__.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,5 @@
22

33
from .tracer import Run, Tracer, trace
44

5-
__version__ = "0.1.12"
5+
__version__ = "0.1.13"
66
__all__ = ["Tracer", "Run", "trace"]

‎browsertrace/cli.py‎

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,14 @@
2323
from pathlib import Path
2424
from typing import Optional
2525

26+
from . import __version__
2627
from .tracer import DEFAULT_HOME
2728

29+
GITHUB_UI_INSTALL = (
30+
"browsertrace[ui] @ "
31+
f"git+https://github.com/aaronlab/browsertrace@v{__version__}"
32+
)
33+
2834

2935
def _home() -> Path:
3036
import os
@@ -111,7 +117,7 @@ def cmd_doctor(_args) -> int:
111117
]
112118
if missing_ui:
113119
print(f"UI dependencies: missing {', '.join(missing_ui)}")
114-
print('Install: pip install "browsertrace[ui]"')
120+
print(f'Install: pip install "{GITHUB_UI_INSTALL}"')
115121
else:
116122
print("UI dependencies: available")
117123

‎docs/browser-use-debugging.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -260,9 +260,9 @@ <h2>Why this exists</h2>
260260
<h2>Try it before wiring Browser Use</h2>
261261
<div class="command-block">
262262
<button class="copy-button" type="button" data-copy-target="quickstart-command">Copy</button>
263-
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
264-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
265-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace</code></pre>
263+
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
264+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
265+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace</code></pre>
266266
</div>
267267
<p>Open <code>http://127.0.0.1:3000</code>, then inspect <code>demo: checkout agent fails on disabled button</code>. From a source checkout, <code>python examples/browser_use_callback_demo.py</code> records Browser Use-shaped callback steps without installing Browser Use.</p>
268268
</section>

‎docs/computer-use-agent-debugging.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -255,9 +255,9 @@ <h1>Debug custom computer-use agents with browser state and model I/O</h1>
255255
<h2>Try the local demo first</h2>
256256
<div class="command-block">
257257
<button class="copy-button" type="button" data-copy-target="quickstart-command">Copy</button>
258-
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
259-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
260-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace</code></pre>
258+
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
259+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
260+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace</code></pre>
261261
</div>
262262
<p>Open <code>http://127.0.0.1:3000</code> and inspect the failed checkout-agent run. The demo does not require an API key. From a source checkout, <code>python examples/computer_use_loop_example.py</code> creates a generic observe-decide-act trace for a custom agent loop.</p>
263263
</section>

‎docs/debug-browser-agent-failure.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -212,9 +212,9 @@ <h2>The failure pattern</h2>
212212
<h2>Run a local trace</h2>
213213
<div class="command-block">
214214
<button class="copy-button" type="button" data-copy-target="quickstart-command">Copy</button>
215-
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
216-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
217-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace</code></pre>
215+
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
216+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
217+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace</code></pre>
218218
</div>
219219
<p>Open <code>http://127.0.0.1:3000</code>, then click the failed checkout-agent run. You can also inspect the <a href="./">live exported trace</a> without installing anything.</p>
220220
</section>

‎docs/index.html‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -332,8 +332,8 @@ <h1 id="title">Replay an AI browser-agent failure</h1>
332332

333333
<div class="below">
334334
<span>Raw export: <a href="./trace.html">open trace.html</a></span>
335-
<span>Release asset: <a href="https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo.html">download browsertrace-demo.html</a></span>
336-
<span>Public-safe export: <a href="https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo-public.html">download browsertrace-demo-public.html</a></span>
335+
<span>Release asset: <a href="https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo.html">download browsertrace-demo.html</a></span>
336+
<span>Public-safe export: <a href="https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo-public.html">download browsertrace-demo-public.html</a></span>
337337
</div>
338338

339339
<section class="quickstart" aria-labelledby="quickstart-title">
@@ -343,9 +343,9 @@ <h2 id="quickstart-title">Run the same failure locally</h2>
343343
</div>
344344
<div class="command-block">
345345
<button class="copy-button" type="button" data-copy-target="quickstart-command">Copy</button>
346-
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
347-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
348-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace</code></pre>
346+
<pre><code id="quickstart-command">uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
347+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
348+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace</code></pre>
349349
</div>
350350
</section>
351351
</main>

‎docs/launch/channel-copy.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ https://aaronlab.github.io/browsertrace/debug-browser-agent-failure.html
1414

1515
Public-safe demo export for privacy-sensitive replies:
1616

17-
https://github.com/aaronlab/browsertrace/releases/download/v0.1.12/browsertrace-demo-public.html
17+
https://github.com/aaronlab/browsertrace/releases/download/v0.1.13/browsertrace-demo-public.html
1818

1919
## X
2020

@@ -45,12 +45,12 @@ https://github.com/aaronlab/browsertrace
4545
```text
4646
The shortest way to try BrowserTrace:
4747
48-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
49-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
50-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace
48+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
49+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
50+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace
5151
5252
Persistent install from the GitHub tag also works:
53-
pip install "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12"
53+
pip install "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13"
5454
browsertrace doctor
5555
browsertrace demo
5656
browsertrace
@@ -118,8 +118,8 @@ The repo has a no-API deterministic demo and a live exported HTML trace if you w
118118
https://aaronlab.github.io/browsertrace/
119119
120120
Before PyPI publishing is enabled, the no-install uvx path is:
121-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace doctor
122-
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.12" browsertrace demo
121+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace doctor
122+
uvx --from "browsertrace[ui] @ git+https://github.com/aaronlab/browsertrace@v0.1.13" browsertrace demo
123123
124124
I'd like feedback from people who are building or testing browser agents. What browser state do you wish your current traces captured?
125125
```

0 commit comments

Comments
 (0)