Skip to content

feat: add Helium browser to macOS DevToolsActivePort discovery#41

Open
nikolay-bratanov wants to merge 1 commit into
pasky:mainfrom
nikolay-bratanov:feat/helium-macos-support
Open

feat: add Helium browser to macOS DevToolsActivePort discovery#41
nikolay-bratanov wants to merge 1 commit into
pasky:mainfrom
nikolay-bratanov:feat/helium-macos-support

Conversation

@nikolay-bratanov

Copy link
Copy Markdown

Summary

Adds Helium (net.imput.helium) to the macOS browser candidates in getWsUrl() so default discovery picks up its DevToolsActivePort without requiring CDP_PORT_FILE.

   const macBrowsers = [
     'Google/Chrome', 'Google/Chrome Beta', 'Google/Chrome for Testing',
     'Chromium', 'BraveSoftware/Brave-Browser', 'Microsoft Edge',
+    'net.imput.helium',
   ];

Helium is a privacy-focused Chromium fork for macOS. It uses its bundle id as the profile directory name (under ~/Library/Application Support/), which is why it falls outside the existing entries.

Tested

  • Helium 0.11.7.1 (Chromium 147.0.7727.137 base) on macOS 15.4
  • cdp list, cdp shot, cdp nav all working end-to-end

Note: Helium also requires --remote-allow-origins=* at launch (Chromium 128+ origin allowlist) for any cdp.mjs command to actually succeed — that's documented separately in #40 and is browser-side configuration, unrelated to this change.

Test plan

  • cdp list discovers Helium's DevToolsActivePort automatically (no CDP_PORT_FILE env var).
  • Other browsers (Chrome, Brave, etc.) unaffected.

Helium (https://helium.computer, package net.imput.helium) is a
privacy-focused Chromium fork for macOS. It writes DevToolsActivePort to
~/Library/Application Support/net.imput.helium/, which the existing
discovery list does not cover, so the tool falls back to "No
DevToolsActivePort found" or requires the CDP_PORT_FILE workaround.

Add 'net.imput.helium' to macBrowsers so default discovery picks it up
the same way it does Chrome, Brave, and Chromium.

Tested on macOS 15.4 with Helium 0.11.7.1 (Chromium 147.0.7727.137 base).
The remote-debugging port is enabled via chrome://inspect/#remote-debugging
toggle; Helium also requires --remote-allow-origins=* at launch (Chromium
128+ origin allowlist), which is browser-side configuration unrelated to
this change.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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