Skip to content

feat(browser): support custom Chromium binaries with isolated profiles - #462

Merged
beubax merged 35 commits into
mainfrom
feat/custom-browser-binary-path
Sep 2, 2026
Merged

feat(browser): support custom Chromium binaries with isolated profiles#462
beubax merged 35 commits into
mainfrom
feat/custom-browser-binary-path

Conversation

@rishabhraj36

@rishabhraj36 rishabhraj36 commented Aug 28, 2026

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, while managed Cloak 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.

Custom browsers now receive isolated profile directories under ~/.webcmd/<browser>/profiles. Known ChromiumFish and Clark paths resolve to stable namespaces, named application bundles such as Brave and Google Chrome use their application name, and unknown Chromium executables use a deterministic path-derived namespace. Managed Cloak continues using ~/.webcmd/cloak/profiles.

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)

Verification

  • Browser/profile focused tests: 85 passed after merging latest origin/main
  • npm run typecheck: passed
  • npm run build: passed before the latest upstream merge
  • Real Google Chrome macOS smoke: doctor connected and created ~/.webcmd/google-chrome/profiles/default
  • Real ChromiumFish macOS smoke: doctor connected; Google search returned results
  • Real Clark Browser macOS smoke: doctor connected; Google search returned results
  • Independent Claude follow-up review session 26e4c008-a81a-406c-941f-166d21e115a3: no blocking findings

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

@github-actions

github-actions Bot commented Aug 28, 2026

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
@rishabhraj36 rishabhraj36 changed the title feat(browser): support custom Chromium binary path feat(browser): support custom Chromium binaries with isolated profiles Aug 31, 2026
@beubax
beubax merged commit fde64e2 into main Sep 2, 2026
15 checks passed
beubax added a commit that referenced this pull request Sep 2, 2026
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.

2 participants