preview-build

name	preview-build
description	Use when you need to load a specific published preview/nightly extension build into the agent's browser by run-number, branch name, or tag. Faster than rebuilding locally when you only want to exercise an existing artifact.

preview-build

Resolve a GitHub release published by CI (nightly or branch-preview), download its Chrome zip, expand it to .tmp/, and load that directory instead of a local build. For exploring the build you just compiled, use browser-verify instead.

Prerequisites

• gh CLI authenticated against this repo
• A shell with unzip (macOS/Linux/git-bash) or Expand-Archive (PowerShell)

If any are missing, stop and tell the human.

1. Resolve the release

By nightly run-number (the (<BUILD>) in the title):

gh release list --limit 50 --json tagName,name \
  --jq '.[] | select(.name | test("\\(<BUILD>\\)$")) | .tagName'

By branch:

gh release view preview-branch-<branch-slug> --json tagName,assets,name

Latest nightly:

gh release list --limit 5 --json tagName,name,createdAt \
  --jq 'map(select(.name | startswith("Preview Build nightly-"))) | sort_by(.createdAt) | last | .tagName'

Substitute <BUILD> / <branch-slug> at the call site.

2. Download + expand

Both shells end with an unpacked/ directory under .tmp/ (gitignored).

Unix / git-bash:

TAG=<tag from step 1>
ASSET=$(gh release view "$TAG" --json assets --jq '.assets[] | select(.name | endswith("-chrome.zip")) | .name')
DEST=.tmp/preview-$TAG
mkdir -p "$DEST"
gh release download "$TAG" --pattern "$ASSET" --dir "$DEST"
unzip -q "$DEST/$ASSET" -d "$DEST/unpacked"

PowerShell (parse the JSON in PowerShell rather than passing a jq filter through the native-command boundary, which mangles quotes):

$TAG = '<tag from step 1>'
$ASSET = ((gh release view $TAG --json assets | ConvertFrom-Json).assets | Where-Object { $_.name -like '*-chrome.zip' }).name
$DEST = ".tmp/preview-$TAG"
New-Item -ItemType Directory -Force -Path $DEST | Out-Null
gh release download $TAG --pattern $ASSET --dir $DEST
Expand-Archive -Path "$DEST/$ASSET" -DestinationPath "$DEST/unpacked" -Force

3. Load into the browser

Point the Playwright CLI at the unpacked directory instead of build/. Copy the config pnpm run verify:explore writes, and swap the two extension paths for the absolute path to unpacked/:

"args": [
  "--enable-unsafe-extension-debugging",
  "--disable-extensions-except=<abs>/.tmp/preview-<tag>/unpacked",
  "--load-extension=<abs>/.tmp/preview-<tag>/unpacked"
]

Then open a session as in browser-verify, using a fresh session name so the profile is disposable. Resolve the absolute path from the current working directory (pwd / Get-Location); don't embed a host-specific prefix.

The dev API (globalThis.__da) is NOT present in these builds; nightly tags ship prod, and attachDevApi is gated by !IS_DA_PROD. Seed state via chrome.storage.set directly.

4. Tear down

npx -y @playwright/cli@0.1.18 -s=<session> close

A leftover session holds a browser process and its profile directory.

Gotchas

• Build numbers are not stable across forks. The parenthetical in the title is this repo's GitHub Actions run_number.
• Branch-preview release tags get overwritten by new pushes. Grab the asset immediately if bisecting; only nightly tags are stable.
• The Firefox zip is not loadable in Chromium. Pick the -chrome.zip asset.