From 049d7aa3da3724c39d94c3e287aac25ccb1ee863 Mon Sep 17 00:00:00 2001
From: Richard Gill <richard@rgill.co.uk>
Date: Fri, 9 Jan 2026 09:20:35 +0000
Subject: [PATCH] feat: support DEV_BROWSER_EXECUTABLE_PATH for custom chromium
 binary

Useful for NixOS and other systems where Playwright's bundled
Chromium doesn't work out of the box.
---
 README.md                       | 4 ++++
 skills/dev-browser/src/index.ts | 1 +
 2 files changed, 5 insertions(+)

diff --git a/README.md b/README.md
index a599826..32e7758 100644
--- a/README.md
+++ b/README.md
@@ -66,6 +66,10 @@ The Chrome extension allows Dev Browser to control your existing Chrome browser
 
 When active, Claude can control your existing Chrome tabs with all your logged-in sessions, cookies, and extensions intact.
 
+## Configuration
+
+Optionally set `DEV_BROWSER_EXECUTABLE_PATH` to use a custom Chromium binary.
+
 ## Permissions
 
 To skip permission prompts, add to `~/.claude/settings.json`:
diff --git a/skills/dev-browser/src/index.ts b/skills/dev-browser/src/index.ts
index 22fc2e4..4ea017c 100644
--- a/skills/dev-browser/src/index.ts
+++ b/skills/dev-browser/src/index.ts
@@ -82,6 +82,7 @@ export async function serve(options: ServeOptions = {}): Promise<DevBrowserServe
   // Launch persistent context - this persists cookies, localStorage, cache, etc.
   const context: BrowserContext = await chromium.launchPersistentContext(userDataDir, {
     headless,
+    executablePath: process.env.DEV_BROWSER_EXECUTABLE_PATH || undefined,
     args: [`--remote-debugging-port=${cdpPort}`],
   });
   console.log("Browser launched with persistent profile...");