BRAPI-1041: Add browser rendering commands to wrangler by ruifigueira · Pull Request #13159 · cloudflare/workers-sdk

ruifigueira · 2026-03-31T23:16:44Z

Add wrangler browser list and wrangler browser open commands for managing Browser Rendering DevTools sessions. Also adds browser:write OAuth scope to wrangler login.

Fixes BRAPI-1041

Tests
- Tests included/updated
- Automated tests not possible - manual testing has been completed as follows:
- Additional testing not necessary because:
Public documentation
- Cloudflare docs PR(s): [Browser Rendering] Add Wrangler CLI commands documentation cloudflare-docs#29607
- Documentation not necessary because:

A picture of a cute animal (not mandatory, but encouraged)

changeset-bot · 2026-03-31T23:16:49Z

🦋 Changeset detected

Latest commit: 46aea44

The changes in this PR will be included in the next version bump.

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

github-actions · 2026-03-31T23:17:18Z

✅ All changesets look good

Summary: 9 changesets reviewed - all pass validation.

File	Package	Version	Notes
browser-rendering-cli.md	wrangler	minor	New browser commands with good examples
add-artifacts-oauth-scope.md	wrangler	minor	OAuth scope addition
happy-cameras-occur.md	@cloudflare/local-explorer-ui	patch	Error handling improvements
dependabot-update-13393.md	miniflare, wrangler	patch	Dependency update (workerd)
update-local-explorer-sidebar.md	@cloudflare/local-explorer-ui	minor	New UI features (theme, persistence)
add-preview-commands.md	wrangler	minor	New preview command family (beta)
add-preview-output-entry.md	wrangler	minor	Output file entries for preview
queue-broker-metrics-response.md	miniflare	patch	Queue broker metadata response
add-flagship-binding.md	miniflare, wrangler, @cloudflare/workers-utils	minor	Flagship feature flag binding

All changesets:

Use appropriate version types (minor for features, patch for fixes/updates)
Have meaningful descriptions
Contain no h1/h2/h3 headers
Properly identify experimental/beta features where applicable

ask-bonk · 2026-03-31T23:19:01Z

UnknownError: Your AI Gateway has authentication active, but you didn't provide a valid apiKey

github run

ask-bonk · 2026-03-31T23:19:04Z

@ruifigueira Bonk workflow failed. Check the logs for details.

View workflow run · To retry, trigger Bonk again.

pkg-pr-new · 2026-03-31T23:20:53Z

create-cloudflare

npm i https://pkg.pr.new/create-cloudflare@13159

@cloudflare/kv-asset-handler

npm i https://pkg.pr.new/@cloudflare/kv-asset-handler@13159

miniflare

npm i https://pkg.pr.new/miniflare@13159

@cloudflare/pages-shared

npm i https://pkg.pr.new/@cloudflare/pages-shared@13159

@cloudflare/unenv-preset

npm i https://pkg.pr.new/@cloudflare/unenv-preset@13159

@cloudflare/vite-plugin

npm i https://pkg.pr.new/@cloudflare/vite-plugin@13159

@cloudflare/vitest-pool-workers

npm i https://pkg.pr.new/@cloudflare/vitest-pool-workers@13159

@cloudflare/workers-editor-shared

npm i https://pkg.pr.new/@cloudflare/workers-editor-shared@13159

wrangler

npm i https://pkg.pr.new/wrangler@13159

commit: 46aea44

workers-devprod · 2026-04-06T08:32:29Z

Codeowners approval required for this PR:

✅ @cloudflare/wrangler

Show detailed file reviewers

packages/wrangler/src/user/user.ts

packages/wrangler/src/browser-rendering/utils.ts

packages/wrangler/src/browser-rendering/close.ts

packages/wrangler/src/browser-rendering/create.ts

packages/wrangler/src/browser-rendering/view.ts

packages/wrangler/src/browser-rendering/connect.ts

packages/wrangler/src/browser-rendering/view.ts

petebacondarwin

A few NITS, and needs a rebase, but looks good to me.
Once those are resolved you should be able to merge - or we can for you. Thanks!

packages/wrangler/src/browser-rendering/connect.ts

packages/wrangler/src/browser-rendering/create.ts

workers-devprod

Codeowners reviews satisfied

packages/wrangler/src/__tests__/browser-rendering.test.ts

Requested changes have been addressed

When multiple sessions or targets exist, the connect command now throws an error requiring explicit selection via session ID or --target flag, rather than outputting all items as JSON. This makes the behavior consistent: --json only works when the command can actually connect.

- Use JsonFriendlyFatalError for JSON-mode errors in connect.ts - Move shouldOpen calculation inside else block in create.ts - Extract throwIfNonInteractive helper to reduce duplication

workers-devprod added this to workers-sdk Mar 31, 2026

github-project-automation bot moved this to Untriaged in workers-sdk Mar 31, 2026

ruifigueira force-pushed the rfigueira/browser-run-cli branch 5 times, most recently from f1e8772 to ab5d092 Compare April 6, 2026 07:54

ruifigueira changed the title ~~[wrangler] Add browser rendering CLI commands~~ BRAPI-1041: Add browser rendering commands to wrangler Apr 6, 2026

ruifigueira marked this pull request as ready for review April 6, 2026 08:32

ruifigueira requested a review from workers-devprod as a code owner April 6, 2026 08:32

workers-devprod requested review from a team and penalosa and removed request for a team April 6, 2026 08:32

This comment was marked as resolved.

Sign in to view

penalosa previously requested changes Apr 9, 2026

View reviewed changes

github-project-automation bot moved this from Untriaged to In Review in workers-sdk Apr 9, 2026

This comment was marked as resolved.

Sign in to view

ruifigueira force-pushed the rfigueira/browser-run-cli branch from cfc881d to 074c5f5 Compare April 9, 2026 11:46

ruifigueira requested a review from penalosa April 9, 2026 12:16

ruifigueira force-pushed the rfigueira/browser-run-cli branch from 074c5f5 to 9bbdbd4 Compare April 10, 2026 03:18

petebacondarwin approved these changes Apr 10, 2026

View reviewed changes

packages/wrangler/src/browser-rendering/connect.ts Outdated Show resolved Hide resolved

packages/wrangler/src/browser-rendering/create.ts Show resolved Hide resolved

packages/wrangler/src/browser-rendering/create.ts Outdated Show resolved Hide resolved

ruifigueira force-pushed the rfigueira/browser-run-cli branch from 8a0cc36 to d294765 Compare April 10, 2026 12:22

workers-devprod approved these changes Apr 10, 2026

View reviewed changes

This comment was marked as resolved.

Sign in to view

ruifigueira force-pushed the rfigueira/browser-run-cli branch 5 times, most recently from ec89c44 to 58e7c27 Compare April 10, 2026 15:34

ruifigueira requested a review from petebacondarwin April 10, 2026 16:16

petebacondarwin reviewed Apr 10, 2026

View reviewed changes

packages/wrangler/src/__tests__/browser-rendering.test.ts Outdated Show resolved Hide resolved

ruifigueira added 11 commits April 10, 2026 20:21

BRAPI-1041: Add browser rendering commands to wrangler

2fffe29

BRAPI-1041: return valid JSON for browser list --json with no sessions

759d771

BRAPI-1041: improve browser command error handling

a9f2647

BRAPI-1041: handle non-interactive mode for browser open command

316f1af

BRAPI-1041: Addressing review comments

efd72db

BRAPI-1041: Rename open to connect and add --open flag

5e70f4e

BRAPI-1041: Simplify JSON output in browser commands

fa8a12c

BRAPI-1041: Address review comments

093f6da

- Use JsonFriendlyFatalError for JSON-mode errors in connect.ts - Move shouldOpen calculation inside else block in create.ts - Extract throwIfNonInteractive helper to reduce duplication

BRAPI-1041: Rename connect command to view

7160fb3

BRAPI-1041: oops

46aea44

ruifigueira force-pushed the rfigueira/browser-run-cli branch from 1b6455e to 46aea44 Compare April 10, 2026 19:22

ruifigueira merged commit bafb96b into main Apr 10, 2026
56 of 57 checks passed

ruifigueira deleted the rfigueira/browser-run-cli branch April 10, 2026 21:35

github-project-automation bot moved this from In Review to Done in workers-sdk Apr 10, 2026

workers-devprod mentioned this pull request Apr 10, 2026

Version Packages #13375

Merged

petebacondarwin pushed a commit that referenced this pull request Apr 13, 2026

BRAPI-1041: Add browser rendering commands to wrangler (#13159)

e4ac59c

Conversation

ruifigueira commented Mar 31, 2026 • edited by devin-ai-integration bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

changeset-bot bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

github-actions bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

ask-bonk bot commented Mar 31, 2026

Uh oh!

ask-bonk bot commented Mar 31, 2026

Uh oh!

pkg-pr-new bot commented Mar 31, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

workers-devprod commented Apr 6, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This comment was marked as resolved.

Uh oh!

petebacondarwin left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

workers-devprod left a comment

Choose a reason for hiding this comment

Uh oh!

This comment was marked as resolved.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ruifigueira commented Mar 31, 2026 •

edited by devin-ai-integration bot

Loading

changeset-bot bot commented Mar 31, 2026 •

edited

Loading

github-actions bot commented Mar 31, 2026 •

edited

Loading

pkg-pr-new bot commented Mar 31, 2026 •

edited

Loading

workers-devprod commented Apr 6, 2026 •

edited

Loading

petebacondarwin left a comment •

edited

Loading