Skip to content

feat(browser): support custom Chromium binary path - #462

Open
rishabhraj36 wants to merge 2 commits into
mainfrom
feat/custom-browser-binary-path
Open

feat(browser): support custom Chromium binary path#462
rishabhraj36 wants to merge 2 commits into
mainfrom
feat/custom-browser-binary-path

Conversation

@rishabhraj36

Copy link
Copy Markdown
Collaborator

Description

Adds an optional WEBCMD_BROWSER_BINARY_PATH environment override for compatible Chromium executables. The Webcmd-owned variable takes precedence over the existing CLOAKBROWSER_BINARY_PATH variable, while the managed Cloak browser remains the unchanged default when neither is set.

The override is forwarded to persistent Playwright launches and mirrored into CloakBrowser configuration so managed binary resolution and downloads are skipped. On macOS, custom executables use the normal Playwright persistent launcher because third-party app bundles may not implement the managed browser background-CDP contract. Doctor validates and reports the effective override.

Related issue: none

Type of Change

  • 🐛 Bug fix
  • ✨ New feature
  • 🌐 New site adapter
  • 📝 Documentation
  • ♻️ Refactor
  • 🔧 CI / build / tooling

Checklist

  • I ran the checks relevant to this PR
  • I updated tests or docs if needed
  • I included output or screenshots when useful
  • If I edited skill-src/, I ran make build and committed skills/ (not applicable)

Adapter Notes

  • Updated generated or lean docs when command discoverability changed (not applicable)
  • Used positional args for the command primary subject unless a named flag is clearly better (not applicable)
  • Normalized expected adapter failures to CliError subclasses instead of raw Error (not applicable)

Verification

  • Targeted unit tests: 128 passed
  • npm run typecheck: passed
  • npm run build: passed
  • Real ChromiumFish macOS smoke: doctor connected; google search github returned results
  • Real Clark Browser macOS smoke: doctor connected; google search github returned results
  • Independent Claude review session 2c052e4a-3235-46c6-be17-0aed2c05d3c8: no release-blocking findings

The full unit/plugin suite passed 6,265 tests and had five unrelated existing DNS-policy failures in src/fetch/safe-proxy.test.ts under local Node 26.7.0.

@github-actions

Copy link
Copy Markdown
Contributor

🟠 Maintainer review suggested — low confidence

The automated review could not reach a fully supported conclusion.

Limitations

  • The automated review returned an invalid structured result.

This review is advisory and does not block merging.

@rishabhraj36
rishabhraj36 requested a review from beubax August 28, 2026 12:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant